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PREFACE 
ORACLE FOR IBM PC/MS-DOS 


The ORACLE RDBMS is sold in two configurations for 
PC/MS-DOS: 


€ Professional ORACLE is designed to run on a stand-alone 
computer (one not attached to a computer network). You 
must be using an IBM AT or equivalent Oracle-certified AT 
compatible to run Professional ORACLE. 


Professional ORACLE includes: 
ORACLE RDBMS 
ORACLE Utilities 
SQL*Calc 
SQL*Plus 
SQL*Forms 
SQL*Report 
Pro*C 


= Networkstation ORACLE is designed to run on a computer 
that is attached to a computer network, with the ORACLE 
database software installed elsewhere on the network. It al- 
lows you to manipulate the contents of the ORACLE data- 
base just as if the database were stored on your own 
computer. You can run Networkstation ORACLE on an 
IBM PC/XT or AT or equivalent Oracle-certified compat- 
ibles. 


Networkstation ORACLE includes: 
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SOL*Net 
ORACLE Utilities 
SQL*Calc 
SOL*Plus 
SQL*Forms 

SQL* Report 


RELATED PUBLICATIONS 


Documents provided for the ORACLE RDBMS are: 
a ORACLE Utilities User's Guide, Oracle Part No. 3602 


® ORACLE Database Administrator's Guide, Oracle Part No. 
3601 


e ORACLE Error Messages and Codes, Oracle Part No. 3605 


® ORACLE for IBM PC/MS-DOS Installation and User's Guide 
(this guide), Oracle Part No. 1022 


a SOL Primer, Oracle Part No. 3807 


ORACLE for IBM PC/MS-DOS System Release Bulletin, 
Oracle Part No. 428-V5.1A. 


Documents provided for SQL*Report are: 

= SQL* Report User's Guide, Oracle Part No. 3603 

Documents provided for SQL*Plus are: 

a SQL*Plus Release Notes, Oracle Part No. 3003 

= SQL* Plus User's Guide, Oracle Part No. 3201 

= SQL*Plus Reference Guide, Oracle Part No. 3203 
® SOL*Plus Reference Card, Oracle Part No. 3703 
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Documents provided for SQL*Forms are: 

e SQL*Forms Release Notes, Oracle Part No. 3004 

= Introduction to SOL*Forms, Oracle Part No. 19192-1286 
SQL* Forms Operator's Guide, Oracle Part No. 3301 
SQL*Forms Designer's Tutorial, Oracle Part No. 3302 

a SOL*Forms Designer's Reference, Oracle Part No. 3304 

=" SQL*Forms Operator's Reference Card, Oracle Part No. 3704 
= SOL*Forms Designer's Reference Card, Oracle Part No. 3708 


Documents provided for SQL*Calc are: 

a Introduction to SQL* Calc, Oracle Part No. 3809 

a SQL*Calc User's Guide, Oracle Part No. 3401 

= SQL*Calc Reference Card, Oracle Part No. 3705 
Documents provided for SQL*Net are: 

a SOL*Net Release Notes, Oracle Part No. 3016 

= SOL*Net User's Guide, Oracle Part No. 3604 
Documents provided for the Programmatic Interfaces are: 
= Pro*C User's Guide, Oracle Part No. 3504 

= Pro* COBOL User's Guide, Oracle Part No. 3503 


YOUR COMMENTS ARE WELCOME 


We value and appreciate your comments as an ORACLE user 
and reader of the manuals. As we write, revise, and evaluate, 
your opinions are the most important input we receive. At the 
back of this manual is a Reader's Comment Form, which we 
encourage you to use to tell us what you like and dislike about 
this (or other) ORACLE manuals. If the form is gone, or if you 
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would like to contact us, please use the following address, or call 
us at (415)598-8000. 

Technical Publications Manager 

Oracle Corporation 

20 Davis Drive 

Belmont, California 94002 
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CHAPTER 1. AN INTRODUCTION TO ORACLE 


The ORACLE RDBMS is a relational database management 
system compatible with SQL/DS and DB2, IBM database sys- 
tems that run on large IBM computers. In addition, ORACLE 
runs on many different mainframe computers, minicomputers, 
and microcomputers. Professional ORACLE is a single user 
version of ORACLE for IBM PC ATs and 100% Compatibles. 
It is the same full function ORACLE that is available on over 
30 operating systems and 80 hardware platforms. Using the 
same ORACLE software under MS-DOS that runs on other 
computers you can network and/or share data with other com- 
puters easily. 


ORACLE storcs large amounts of information ready for instant 
use or update. The system’s basic design is easy to understand; 
it uses two-dimensional tables to store data, and it allows you 
to define relationships between items in a table and between 
items in different tables. The ORACLE Database is accessed 
via a high-level query language called: Structured Query Lan- 
guage, or SQL (pronounced “sequel”). SQL allows you to re- 
trievc, insert, update, and delete data; add new tables to the 
database; protect private data; and more. SQL is easy to learn 
because you use it to specify what is to happen rather than how 
to make it happen. Yet it offers power to those who use its more 
sophisticated features. SQL can be used through an interactive 
interface or by embedding statements in programs written in a 
procedural language such as C or COBOL. 


ORACLE software is the same for all computers on which it 
runs, so most of the documentation is also the same. For ex- 
ample, the SOL* Plus User's Guide that you received is the same 
one you would receive for ORACLE on a minicomputer. 
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Only a small portion of the ORACLE documentation 1s specific 
to a particular opcrating system and computer. This book and 
the ORACLE for IBM PC/[MS-DOS System Release Bulletin are 
the only ORACLE documentation that is unique for 
PC/MS-DOS. 


GETTING STARTED WITH ORACLE 


If you are using ORACLE on other operating systems you will 
already be familiar with SQL and the ORACLE tools in your 
environment. [Iowcver if you are new to using ORACLE and 
the SQL language then read on for guidelines on getting ac- 
quainted with ORACLE for PC/MS-DOS. 


|. Read Chapter 1 of this guide and the SQL Primer for general 
information about ORACLE, its complement of software 
tools, and the ORACLE query language -- SQL. This will 
provide you with an overview of ORACLE and familiarize 
you with SQL. 


2. Read and follow the directions in Chapter 2, "Installing 
ORACLE for the First Time” to install ORACLE. Be sure 
to read the ORACLE for IBM PC/MS-DOS System Release 
Bulletin for any up-to-thc-minute information on installation. 
This will tell you how to install ORACLE in detail. 


3. Read Chapter 3, “Administering Your System." This chapter 
explains your role as database administrator. As a single user 
you really arc your own database administrator. This chapter 
discusses the simple tasks that you will need to perform like 
setting up your user ID. It also includes more detailed in- 
formation for managing your ORACLE database. 


4. The next step, after you have installed ORACLE and set up 
your user [D, is to begin using the various ORACLE tools 
provided, and you can read about them in Part II of this 
guide. The first tool you will want to use is SQL*Plus, 
ORACLE 's interactive SOL command processor. SQL*Plus 
lets you create the tables that will make up your applications. 
The SQL Primer and Part I of the SQL* Plus User's Guide . 
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ORACLE Utilities 


are your introduction to SQL*Plus. SQL*Plus will also take 
care of the majority of your reporting needs. For more so- 
phisticated reporting use SQL*Roeport. 


5. SOL*Forms is ORACLE 's application development tool. It 
allows you to both prototype and develop sophisticated full 
screen applications. To become acquainted with 
SQL*Forms, read the booklets Introduction To SQL* Forms, 
and SOL* Forms Designer's Tutorial 


6. Once you arc comfortable using ORACLE, you may wish to 
make changes to the basic installation to suit your particular 
needs. Consult Chapter 4, "Customizing Your Installation", 
in this document. 


The ORACLE RDBMS includes facilities for maintaining the 
database and performing administrative tasks such as backing 
up and restoring data (routine tasks) and handling space allo- 
cation (nonroutinc tasks). It also includes utilities for such tasks 
as loading data into the ORACLE database from ordinary 
MS-DOS files, and creating custom definitions for display de- 
vices and keyboards. 


ORACLE utilities are: 


CCF creates MS-DOS files used to store database informa- 
tion. 


CRT processes CRT files, which control several aspects of 
how ORACLE uses your computer’s keyboard and dis- 


play. 


EXP “exports” data from the database to an ordinary 
MS-DOS file. 


IMP imports data exported by EXP. 
IOR initializes a database and starts ORACLE. 


ODL loads data from ordinary MS-DOS files into an 
ORACLE database. 
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SGI displays the size of the System Global Area. 


ORACLE Tools 


Each configuration of ORACLE includes a group of software 
tools that perform a variety of functions: 


SQL* Plus 


SQL* Forms 


SQL*Calc 


SOL*Report 


SQL*Net 


Pro*C 


is the interactive SQL interface. It lets you use 
SQL statements to access the database inter- 
actively, and it provides additional commands 
for editing, formatting and printing for re- 
ports, and also for storing, and retrieving 
queries. 


Is an interactive program for designing and 
using form-based applications. A form is an 
easy way to access a database. An application 
designer creates forms to serve as an applica- 
tion's front end, and an application operator 
fills out forms to enter and retrieve database 
information. 


is an electronic spreadshect similar to Lotus 
1-2-3 that is integrated with ORACLE. You 
can use SQL*Calc to create database tables 
from spreadsheet data, pull database informa- 
tion into a spreadsheet, and move easily be- 
tween database and spreadsheet. 


is a report generation program that allows you 
to include database information in reports and 
to format complex reports. 


enables you to access an ORACLE RDBMS 
running on a different computer in a network. 
SQL*Net is a component of Networkstation 
ORACLE, and may be purchased as an op- 
tional tool for Professional ORACLE. 


allows you to write computer programs in the 
procedural programming language C that refer 
to the contents of the ORACLE database. 
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Pro*COBOL 


Pro*C under PC-DOS and MS-DOS currently 
supports the Lattice and Microsoft C compil- 
ers. Pro*C is a component of Professional 
ORACLE, and may be purchased as an op- 
tional tool for Networkstation ORACLE. 


allows you to write computer programs in the 
procedural programming language COBOL 
that refer to the contents of the ORACLE 
database. Pro*COBOL under PC-DOS and 
MS-DOS currently supports the Realia 
COBOL compiler. Pro*COBOL may be pur- 
chased as an optional tool for either config- 
uration of ORACLE. 
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CHAPTER 2. INSTALLING ORACLE FOR THE FIRST TIME 


This chapter describes how to install Version 5.1 of the 
ORACLE RDBMS and its software tools under PC-DOS or 
MS-DOS. It describes a new installation, not an upgrade from 
the preceding version. 


Professional ORACLE Requirements 


Hardware Requirements 


Software Requirements 


To install and run Professional ORACLE, your computer must 
meet these minimum requirements: 


An IBM Personal Computer AT or Oracle-certified 100% 
compatible computer 


640K bytes of random-access memory (RAM) 


An additional 896K of extended memory; large ORACLE 
applications may require more 


One 5-1/4 inch, double-sided diskette drive 


A fixed (hard) disk. To install all components of Professional 
ORACLE, you will need 7.5 megabytes of free space. 


A color or monochrome display 


IBM’s PC-DOS operating system or Microsoft’s MS-DOS 
operating system, Version 3.0 or higher 
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Networkstation ORACLE Requirements 


Hardware Requirements 


To install and run Networkstation ORACLE, your computer 
must meet these minimum requirements: 


Software Requirements 


An IBM Personal Computer XT or AT or Oracle-certified 
100% compatible computer 


640K bytes of random-access memory (RAM) 
One 5-1/4 inch, double-sided diskette drive 


A fixed (hard) disk. To install all components of 
Networkstation ORACLE, you will need 4.5 megabytes of 
free space. 


A color or monochrome display 


IBM's PC-DOS operating system or Microsoft's MS-DOS 
operating system, Version 2.1 or higher (if you plan to use 
DECnet DOS, you will need Version 3.1 or higher.) 


Printer Note 


Professional ORACLE and Networkstation ORACLE do not 
require specific printers. Both use any printer that can be 
serviced by the PC/MS-DOS "PRINT" command. 
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ORACLE AND YOUR SYSTEM CONFIGURATION 


The ORACLE installation procedure by default creates a direc- 
tory name ORACLES under the root directory. It also creates 
some sub-directories in the ORACLES directory to hold the 
files associated with different parts of ORACLE: 


ROOT DIRECTORY 


ORACLES 


CALC NET 


Figure 1. ORACLES Directory Structure 


BIN holds executable programs and batch files for 
ORACLE and the ORACLE tools. 


CALC holds certain files used by SQL*Calc. 


DBS holds the MS-DOS files that contain the ORACLE 
database, and also several types of associated data 
files and parameter files. 


NET holds certain files used by SQL* Net. 


PRO holds certain files used by the ORACLE 
programmatic interfaces. 
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If you wish, you can change some of the directory names or 
locations. See "Chapter 4. Customizing Your Installation" on 
page 39. 


PROFESSIONAL ORACLE AND EXTENDED MEMORY 


While PC/MS-DOS cannot address memory above 1024K (only 
640K is available for programs), Professional ORACLE's ex- 
tension to MS-DOS givcs the RDBMS the capability to address 
up to 15 MB of additional memory above 1024K. Professional 
ORACLE uses an 80286 or 80386 IBM AT or 100% compatible 
system and runs in the Protected Mode of these processors us- 
ing their ability to directly address EXTENDED memory above 
640K. 


Until Professional ORACLE 's release there had not been any 
MS-DOS applications that took advantage of EXTENDED 
memory (outside of utilities like print spoolers and disk caches). 
This may be a source of confusion for you. There are many 
popular programs that usc what is known as EXPANDED (or 
even ENHANCED EXPANDED) memory. Do not be con- 
fused if you are told that there are no programs that use EX- 
TENDED memory. Professional ORACLE does use 
EXTENDED memory and it is the first application program to 
do so under MS-DOS. 


Because the more common schemes sound like EXTENDED 
you want to make sure that when you first install Professional 
ORACLE you configure your memory card correctly. Most if 
not all popular memory cards permit their configuration as 
EXTENDED memory. To check that you have your memory 
configured correctly, power your system on. Note the maximum 
number that your memory check counts up to. You need a 
minimum of 1536K, or 640K conventional memory and 896K 
EXTENDED memory (your version of MS-DOS may call this 
“expansion memory” during this memory check) without re- 
celving errors, to proceed with the installation. 


If your memory counter does not reach at least 1536K, please 
consult your memory board’s instruction manual to properly 
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install the memory board. If you receive a memory check or 
SETUP error (these errors come from your system), but you 
have at least 1536K from the memory check procedure, then 
you must run your system's SETUP to acknowledge your ex- 
tended memory. 


INSTALLING PROFESSIONAL AND NETWORKSTATION ORACLE 


To install Professional ORACLE, you will run a program called 
ORAINST. ORAINST helps you prepare your system for 
ORACLE, and also copies files and initializes ORACLE soft- 
ware. ORAINST has two parts. 


The first part both prepares and helps to insure that your sys- 
tem 1s ready for both installing and running ORACLE. This 
system preparation step is only invoked once when you first in- 
stall ORACLE on a particular system. It will modify or allow 
you to modify your CONFIG.SYS and AUTOEXEC.BAT files 
and will make sure that ANSI.SYS ts accessible. 


Depending on the present configuration of your computer, you 
may be prompted to re-boot to allow the changes to be enacted, 
and run ORAINST again to continuc the installation. 


After your system is prepared for ORACLE (and if necessary 
you have re-booted and re-run ORAINST), you will be 
prompted through the second part of the install which copies 
the ORACLE software to your hard disk. 


Follow the steps in the following figure to install Professional 
or Networkstation ORACLE. Any differences between install- 
ing the two configurations are described in cach step. 
ORAINST will ask you whether or not you want to install 
Professional ORACLE or Networkstation ORACLE and will 
adjust the installation accordingly. 


For more information about each step, read the sections that 
follow which describe the installation procedure in more detail. 
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Backup the ORACLE diskettes. 
Set your current disk drive to the drive where you want ORACLE to reside. 


Insert the Install diskette into drive A and type 'A:ORAINST' then 
press [Enter]. 


Enter your ORACLE home directory. 
Enter your boot drive. 


. Let ORAINST append ‘\ORACLES\BIN’ to the MS-DOS path in your 
AUTOEXEC. BAT., or do it yourself with an editor. 


Let ORAINST append to your existing CONFIG.SYS or do it yourself with 
an editor and the following commands: 


FILES = 40 

BUFFERS = 16 

BREAK = ON 
DEVICE = CAANSI.SYS 


If it does not already exist there, copy ANSI.SYS from your MS-DOS 
distribution diskette to your root directory. 


If you are prompted to do so by ORAINST, re-start MS-DOS by 
pressing [Ctrl] [Alt] [Del] 


. If you have re-booted, type ORAINST' and press [Enter] to start 
the installation process again. 


. Select what to install - (P)rofessional or (N)etworkstation ORACLE. 


. Install ORACLE Tools. If you are a Professional ORACLE user, 
you will probably want to copy and initialize the Help files at 
this time also. 


] 13. When you are finished, type Q to Quit the install at the menu. 





Figure 2. Installation Checklist 
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System Preparation Steps 


Step 1. Backup the ORACLE Diskettes 


To protect your ORACLE software, make backup copies of all 
diskettes using MS-DOS's DISKCOPY command. See your 
MS-DOS reference manual for information on the DISKCOPY 
command. 


Label the copies carefully, then put the original diskettes in a 
safe place. Use the copies to perform the installation described 
in this chapter. 


Step 2. Set Your Current Disk Drive 


Step 3. Run ORAINST 


Make your computer's current disk drive the fixed disk on 
which you plan to install ORACLE. For example, if you plan 
to install ORACLE on drive C, make drive C the current drive: 


A» C: «RETURN» 
C» 


Remember, the fixed disk must have at lcast 7.5 megabytes of 


free space to accommodate Professional ORACLE and all its 
tools. 


Insert the installation diskette labelled ORACLE Install in drive 
A, and run the ORAINST command: 


C» A:ORAINST <RETURN> 
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Step 4. Enter Your ORACLE Home Directory 


Step 5. Enter Boot Drive 


Enter the directory name in which you want to install 
ORACLE. Press < RETURN?» to accept \ORACLES as the 
default, or enter your own directory. Be sure to include the full 
drive and path. 


Name the drive you will boot from. ORAINST checks to see 
that your CONFIG.SYS and AUTOEXEC.BAT files are set 
correctly so it needs to know what disk you boot from. If you 
are booting ofT A:, make sure your boot disk is accessible. 


Step 6. Modifying the AUTOEXEC.BAT File 


To run ORACLE, you should have an AUTOEXEC.BAT file 
containing commands that tell ORACLE where to find some 

of its files. Each time you start MS-DOS, it looks for this file 
and (if the file exist), executes the commands kept there. 


ORAINST will see if you have an AUTOEXEC.BAT file in the 
boot drive you specified in the previous step. ORAINST will 
automatically create an AUTOEXEC.BAT, or append the nec- 
essary commands to your existing AUTOEXEC.BAT. You are 
also given the option to use your cditor to make the change 
yourself. 


If you choose to do it yourself: 


In your AUTOEXEC.BAT file, define the MS-DOS path to in- 
clude ’C:\ORACLES\BIN’. (If you are not installing on C:, 
substitute the correct drive letter). 


Depending on your system, do onc of the following: 


1. If you have no AUTOEXEC.BAT file, ORAINST creates 
one for you. This provides you with a file that meets 
ORACLE 's requirements. 


2. If your AUTOEXEC.BAT file has no PATH command, add 
the command: 


PATH C:N; C: NORACLESNBIN 
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anywhere in the file. (If you arc not installing on C:, you 
would substitute the letter of the drive you are installing on). 


3. If the AUTOEXEC.BAT file has a PATII command, add 
C:\ORACLES\BIN to it. The position of C:\ORACLES\BIN 
in the PATII command is not critical, but if you will use 
ORACLE extensively you may wish to put it at the beginning 
of the path, as in this example: 


Change this ... PATH C:NBAT; C: NDOS; C: NWP 
to this ... PATH C: NORACLEBNBIN; C: \BAT; C: NDOS; C: \WP 


Be sure that your PATII command includes the name of the 
directory that contains COMMAND.COM. 


4. If you are not installing in the ORACLES directory, you must 
include the SET command: 


SET CONFIG = «ORACLE HOME»CONFIG.ORA 
For example, if you installed in ORATEMP on the D: drive: 
SET CONFIG = D:NORATEMPNCONFIG.ORA 


Where < ORACLE IIOME? is the drive and directory you 
selected to install ORACLE. The CONFIG variable lets 
ORACLE find its file in a non-default directory. This is de- 
scribed in detail in Chapter 4, "Customizing Your Installa- 
tion". 


Step 7. Modify the CONFIG.SYS File 


ORAINST will sec if there is a CONFIG.SYS file in the root 
directory of the system disk. If there is nonc, one will be created 
for you. The CONFIG.SYS file is described in the MS-DOS 
reference manual. 


ORAINST will automatically append the necessary commands 


to CONFIG.SYS or will allow you to use your editor to make 
the change yourself. 
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If you choose to do it yoursclf, modify your CONFIG.SYS file 
as follows: 


1. If there is a FILES command with a value less than 40, 
change it to FILES = 40. If not, insert the command 
FILES - 40. 


2. If there is a BUFFERS command with a value less than 16, 
change it to BUFFERS- 16. If not, insert the command 
BUFFERS= 16. You may already have a higher number for 
BUFFERS- (this is fine). 


3. If there is a BREAK command, make it say BREAK - ON. 
If there is no BREAK command, insert the command 
BREAK - ON. 


4. If there is no DEVICE command referring to ANSI.SYS 
(with or without a pathname before the file name), add the 
command DEVICE = CVANSI.SYS (substituting your drive 
and path). 


Step 8. Put the ANSI.SYS File in the Root Directory 


If ORAINST warned you it could not find ANSI.SYS, or if you 
chose to do it yourself and had to insert the command DE- 
VICE= CAANSI.SYS in the CONFIG.SYS file (or if there was 
no CONFIG.SYS file), you will also nced to copy ANSI.SYS 
to the root directory of the system disk. Copy it from your 
MS-DOS distribution disk (the disk on which you received your 
copy of MS-DOS, not one of the diskettes in the ORACLE 
distribution kit). 


Note on SHELL environment size: 


MS-DOS stores all these parameters (such as paths), in its en- 
vironment With MS-DOS 3.1 or higher, you can increase the 
size of your default environment. This may be necessary if you 
have a long path for example. 


To set a larger COMMAND.COM environment, include the 
following line in CONFIG.SYS: 
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Step 9. Restart the System 


SHELL=C : NCOMMAND.COM /p/e: xxxx 
OR, 
SHELL=C: \DOS\COMMAND.COM /p/e: xxx 


depending on the location of yur COMMAND.COM file. 
XXxx is the environment size in multiples of 16 bytes if you have 
MS-DOS 3.1, or, just bytes if you have MS-DOS 3.2. For 
MS-DOS 3.1, specify at least 32 (the default is 10). If you have 
MS-DOS 3.2, specify at least 360 (the default is 160). 


If ORAINST prompts you to do so, you must restart MS-DOS 
to make it recognize the changes you have made. 


To restart MS-DOS, remove the INSTALL diskette from drive 
A. Then hold down your keyboard's [Ctrl] and [Alt] keys and 
press the [Del] key. 


ORACLE Software Installation Steps 


Step 10. Continue ORAINST 


Step 11. Select What To Install 


ORAINST automatically knows if your system has been pre- 
pared for ORACLE. To continue with your installation, enter 
the ORAINST command: 


C» ORAINST «RETURN» 


This will prompt you through the next steps of the Installation. 


Select (P)rofessional or (N)etworkstation from the menu to let 
ORAINST know which you are installing. Now select whether 
you will install ALL the ORACLE tools that make up Profes- 
sional ORACLE and Networkstation ORACLE, or individual 
tools. You have the option of skipping tools if you do select 
ALL. 
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Step 12. Install ORACLE Tools 


ORAINST automatically prompts you for any specific actions 
with the tool you are installing. 


= As a Professional ORACLE user when you install SQL*Plus, 
you will be asked if you want to copy the SQL*Plus on-line 
help files to your hard disk, and if you want to initialize on- 
line help. If you are a new Professional ORACLE user, you 
will probably want to respond 'Y' to both copy and initialize 
the on-line help files. Initializing Help uses the RDBMS util- 
ities to load IIclp into the database. The utilities disk must 
be installed prior to initializing help. The on-line help files 
require approximately 640K of space in the database. 


If you will be creating a customized database as described in 
Appendix C, then you will only want to copy the Help files 
at this step and NOT initialize them. You will initialize help 
after your new database is set up by running HELPINS.BAT 
as described in Chapter 5, "Using SQL*Plus”. 


= Please note below that the SQL*Forms installation procedure 
has seveal steps: 


l. First, you will select the CRT definition for SQL*Forms. The 
CRT definitions provided are all similar to PC ORACLE 
version 4.1.4 with the exception of NEWBIOS and 
NUBLUBIO. If you are a new ORACLE user, you will want 
to select NEWBIOS or NUBLUBIO because its keystrokes 
are similar to common PC kcy usage. 


2. Next, you will select whether to install SQL*Forms Applica- 
tion Building Software. Do this 1f you intend to use the 
SQL*Forms Designer to build new applications. 


Professional ORACLE Only: 


" [f you are like most users who use the database provided, you 
should choose to load thc extended Data Dictionary for 
SQL*Forms. However, if you will build your own customized 
database as described in Appendix C, or are reinstalling 
SQL*Forms and will use your existing database, be sure to 
run the command FORMINS to load the Extended Data 
Dictionary for SQL*Forms: 
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Note: 


C > CD\ORACLE5\DBS «RETURN» 
C » FORMINS «RETURN» 


Some of the ORACLE product installation processes insert data 
into ORACLE tables. These processes may display repetitive 
messages such as these: 


Table created. 
Table created. 


or 


Grant succeeded. 
Grant succeeded. 


This is normal behavior; it does not indicate that the computer 
is caught in a loop. Do not cancel the installation procedure 
when you sec these messages. 


Step 13. End the Installation Process 


At any point in the install where you have a menu prompt, you 
may quit the installation. 


Installing an ORACLE Tool After ORACLE Has Been Installed 


When you install Professional or Networkstation ORACLE, 
you may choose not to install some of the ORACLE tools. We 
recommend you install (at minimum), RDBMS Utilities, 

SQL* Plus and SOL*Forms. If you choose not to install a tool 
initially, you may install it later at any time. 


To install a tool after ORACLE has been installed: 
l. Start ORACLE: 
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C» ORACLE «RETURN» 


2. Put the first distribution diskette for the ORACLE tool that 
you wish to install in drive A. 


3. Enter the DOS command: 
C» ORAINST «RETURN» 


On your first installation, ORAINST will have prepared your 
system for ORACLE. This includes setting up the ORACLE 
directory structure. The ORACLE directory structure is 
shown in Figure 1 on page 11. 


4. If there are several distribution diskettes for the tool, put each 
diskette in drive A when you are prompted to do so. After 
inserting each diskette, press C to continue. 


5. When you are finished, QUIT at the menu. 


LOADING AND STARTING PROFESSIONAL ORACLE 


If you just finished the installation procedure, ORACLE is cur- 
rently loaded into memory and thc following command will not 
be necessary. 


To start ORACLE, enter the command: 
C» ORACLE «RETURN? 


This command loads the ORACLE RDBMS into memory 
(RAM) from the fixed disk where you installed it, and auto- 
matically “warm-starts” ORACLE (runs the IOR W command). 
The IOR command is described fully in the ORACLE Database 
Administrator's Guide. 


ORACLE consults two files, INIT.ORA and CONFIG.ORA, 
to set general environmental characteristics and to control 
MS-DOS's system resources, respectively. These files can be 
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modified to suit your nceds; see "Chapter 4. Customizing Your 
Installation" on page 39. 


ORACLE displays information about the System Global Area 
(SGA), one of the system resources that can be customized, and 
then displays the message: 


ORACLE WARM STARTED 


LOADING AND STARTING NETWORKSTATION ORACLE 


If you are using Networkstation ORACLE, you must first load 
the SQL*Net protocol driver you will use to communicate with 
the remote database. For example, if you plan to use DECnet 
over a 3Com or MICOM local area network, you must enter: 


C» SQLDNT 
to load the SQL*Net DECncet protocol driver. See "Chapter 8. 


Using SQL*Net” on page 93 for more information about using 
the SOL*Net protocols. 


After you have loaded a SQL*Net protocol driver, you are 
ready to invoke any of the ORACLE tools you have installed. 


STOPPING PROFESSIONAL ORACLE AND REMOVING IT FROM RAM 


When you are done using Professional ORACLE, we recom- 
mend that you formally shutdown the database using the com- 
mand: 


C» IOR S 


This command will shutdown ORACLE but will not remove it 
from RAM. 
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Once you start ORACLE, it remains in your computer's mem- 
ory even when an individual program ends and your computer 
displays the MS-DOS command prompt. Note that ORACLE 
uses only 80K of RAM of the 640K total available in MS-DOS 
3. The majority of ORACLE software resides in extended 
memory. However, you may want to free RAM for use by 
other programs. 


To remove Professional ORACLE from RAM, enter the com- 
mand: 


C> REMORA ALL 


Note: you need not remove ORACLE from RAM before re- 
starting or shutting down your computer. Any time you have 
committed your most recent changes to the database, it is safe 
to restart or shut down the computer. 


STOPPING NETWORKSTATION ORACLE AND REMOVING IT FROM RAM 


Use the REMORA ALL command to remove the SQL* Net 
drivers from RAM. 


USING AN ORACLE TOOL 


Once you start ORACLE, your next step will ordinarily be to 
invoke the ORACLE tool that you want to use, such as 
SQL*Plus or SQL*Forms. At this point, you are required to 
"log on" to ORACLE by starting the tool and entering a previ- 
ously defined user ID and password. Creating your User ID 1s 
described in the next chapter, "Administering Your System". 
For a full description of using ORACLE's tools, see PART II 
of this document, "The ORACLE Tools". 
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CHAPTER 3. ADMINISTERING YOUR SYSTEM 


This chapter introduces you to the responsibilities of the data- 
base administrator (DBA), and describes documentation avail- 
able to help you meet those responsibilities. In addition, this 
chapter provides detailed information about the DBA’s tasks in 
DOS. 


This chapter supplements the information found in the 
ORACLE Database Administrator's Guide. It is important that 
you read that guide as well as this chapter to perform the DBA's 
duties properly. 


IMPORTANT DOCUMENTATION 


Four ORACLE documents contain information that 1s espe- 
cially important to the DBA. 


a ORACLE for IBM PC/MS-DOS Installation and User's Guide 
(this guide) -- contains instructions for installing ORACLE, 
creating a database, customizing the installation, and using 
utilities. Appendix B contains information about the 
CONFIG file, CONFIG.ORA, one of the DBA's means of 
customizing a DOS system. 


" ORACLE Database Administrator's Guide -- contains infor- 
mation on ORACLE terms and concepts, the role of the da- 
tabase administrator, the IOR program, the INIT file, the 
SGI utility, defining and dropping user IDs, data storage and 
data types, consistency and concurrency, tuning for perform- 
ance, and security. 
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Note that some information in this guide is not relevant to a 
DOS system. Non-relevant top:cs are the ORACLE display 
system utility, ORACLE locks, After-Image journaling, and 
other information for systems with multiple concurrent users. 


a ORACLE Utilities User's Guide -- contains information on 
the ORACLE Data Loader utility (for loading data from op- 
erating system files into a database), the EXP ("export") and 
IMP (“import”) utilities (for backing up and restoring data), 
and the CRT utility (for customizing the display and key- 
board). 


a ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering Professional ORACLE and Networkstation 
ORACLE. 


This chapter also refers to the following ORACLE documents. 
You may wish to get access to these documents before you 
proceed: 


=" SOL*Plus Reference Guide 
= SQL*Plus User's Guide 


WHAT IS A DATABASE ADMINISTRATOR? 


The DBA is the person responsible for managing and main- 
taining a database. 


Asa Professional ORACLE user, you are the DBA and are re- 
sponsible for the database administration activities described in 
this chapter and in the ORACLE Database Administrator's 
Guide. These activities include things like: 


a creating user IDs 
s backing up and restoring the database 
= expanding the database 


® performance tuning 
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= auditing and security 
" installing new versions 


Professional ORACLE is initially installed with the user IDs 
SYS and SYSTEM, which have DBA privileges. SYS owns the 
data dictionary tables that are updated automatically by 
ORACLE; you must not alter any of these tables in any way. 
SYSTEM owns various data dictionary views based on the ta- 
bles; altering these views is possible but not recommended. 


As a Networkstation ORACLE user, you are probably in a typ- 
ical time-sharing environment, where many people use a central 
database. In this situation, there is a DBA who assigns user 
IDs, installs new versions of database software, starts and stops 
ORACLE, and handles administrative problems that occur. 
Although these things are not your responsibility, there are 
some administrative tasks you may need to perform. These are 
described in a subsequent section below. 


ADMINISTRATION TASKS; PROFESSIONAL ORACLE ONLY 


Setting Up User IDS 


ORACLE ts shipped with a predefined user ID that has data- 
base administrator (DBA) privileges: SYSTEM, with the pass- 
word MANAGER. Since a user ID with DBA privileges can 
modify certain database tables that are critical to the operation 
of ORACLE itself, SYSTEM should be used only for system 
administration functions. To protect your system, be sure to 
change the default password MANAGER by following these 
steps: 


l. Log on to ORACLE with SQL*Plus using the user ID 
"SYSTEM": 


C» SQLPLUS SYSTEM/MANAGER «RETURN» 
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2. Enter the following SOL*Plus command to enter a new 
password: 


SQL» GRANT CONNECT TO SYSTEM IDENTIFIED BY newpassword «RETURN» 


You should also define an additional user ID, with fewer 
privileges, for everyday use. Type the following DOS com- 
mand to define a new user ID: 


C» ADDUSER SYSTEM/newpassword «RETURN» 


You will then be prompted to enter a ncw user ID and pass- 
word for everyday use. 


Record the new user ID and password in a secure place, so 
that you will not lose them but unauthorized users will not 
gain access to them. 


Now you can use the user ID and password you have just 
created to start any ORACLE tool, such as SQL*Plus. For 
example, if you created the user ID "SCOTT" with the pass- 
word “TIGER,” you can start SQL*Plus with the command: 


C» SQLPLUS SCOTT/TIGER «RETURN» 


Defining A User ID For Automatic Log-on (Professional ORACLE Only) 


ORACLE security demands that every ORACLE user log on 
with a user ID and password provided by the Database Ad- 
ministrator (DBA). 


Sometimes, however, you may wish to permit a user to run ap- 
plications without having to log on and enter a password. You 
can do this by creating an "OPS$ user.” The word "OPSS$" re- 
presents "operating system"; an OPSS user is an "operating sys- 
tem" user in the sense that he or she can run an ORACLE 
program directly from the operating system, without entering a 
user ID and password. 


Log on to SQL*Plus as a DBA (e.g., with the user ID "SYS- 
TEM?) and use SQL*Plus’s GRANT command to create a user 
with the privileges you wish to grant. For example: 
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SQL» GRANT CONNECT, RESOURCE TO OPS$SALES IDENTIFIED BY MONEY; 


Then add the CONFIG parameter USERNAME to the 
CONFIG file that the user in question will invoke at log-on. 
The CONFIG file is described fully in Chapter 4, "Customizing 
Your Installation". Specify the user ID you have just created 
as the value of USERNAME: 


USERNAME - SALES 


Thereafter, when ORACLE reads the CONFIG file, it auto- 
matically assigns the log-on OPSSSALES to anyone who "by- 
passes" log on (presses RETURN instead of entering a user ID 
and password). Because OPSSSALES begins with the prefix 
OPS$, ORACLE allows the user to log on without entering a 
password. 


Defining an OPSS$ user circumvents part of ORACLE 's security, 
since it allows any user to gain access to the database by not 
entering a user ID. Such a user ID may still be prevented from 
gaining access to other uscr IDs' files, though, by granting and 
withholding appropriate privileges to it. Sce the discussion of 
the GRANT command in the SQL* Plus Reference Guide. 


As the DBA for a single-user computer, you are not likely to 
have to create user IDs for a large community of users. There 
are several reasons, though, why you may have to create a cer- 
tain number of user IDs beyond the ones discussed above. 


a To keep track of computer usage by different users 


= To restrict some users’ access to some data for reasons of se- 
curity 


® To allow different users to access the same data in different 
ways (e.g., through differently defined views). 


The description of the GRANT command in the SOL* Plus 
Reference Guide explains how to create a new user ID, change 
a user ID's privileges, or change a user ID's password. The 
ORACLE Database Administrator's Guide discusses other 
considerations that affect creating and giving privileges to 
user IDs. 
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Controlling ORACLE Operating Parameters 


Data and Data Storage 


The operation of ORACLE is influenced by two sets of operat- 
ing parameters: CONFIG parameters, which control aspects of 
ORACLE opcration specifically related to PC-DOS, and INIT 
parameters, which control aspects of ORACLE operation that 
are essentially the same in all implementations. The values of 
these parameters may be changed in a varicty of ways, the sim- 
plest of which is to change their values in the standard INIT 
file, INIT.ORA, and the standard CONFIG file, 
CONFIG.ORA. 


For more information about the use of the INIT and CONFIG 
parameters, see "Chapter 4. Customizing Your Installation" on 
page 39. 


For detailed descriptions of the CONFIG parameters, see Ap- 
pendix B in this guide. 


For general descriptions of the INIT paramcters, see the 
ORACLE Database Administrator's Guide, for information 
about how the INIT parameters in the DOS version of 
ORACLE differ from the paramcters as the ORACLE Database 
Administrator's Guide describes them, sec Figure 3 on page 55. 


The ORACLE Database Administrator's Guide describes the 
SGI utility, a program you can run to ascertain the size of the 
system global arca (SGA). The SGA is an area that ORACLE 
uses to do its work, and its size is based on some values from 
the INIT file. 


A DBA is responsible for such things as expanding the database 
when ORACLE runs out of room and encouraging application 
designers to use database space efficiently. Chapter 6 of the 
ORACLE Database Administrator's Guide contains information 
about how ORACLE stores and uses data. This information is 
useful to both DBAs and application designers. 


Be sure to read about: 
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Expanding the Database 


e ORACLE structures (partitions and files) 
s [Iow to expand the database 

" ORACLE data types and data storage 

# Allocating space to tables 

" How data is stored in tables 

a Calculating your space requirements 

a Creating and using clusters and indexes. 


You can check the data storage of your database using this 
command: 


C» CHKDBS SYSTEM/password «RETURN» 


ORACLE will display the total size of the database and the 
amount of spacc that is available and is not allocated to existing 
tables. There may be spacc in your tables in addition to the 
space not allocated to the tables. 


An ORACLE databasce’s size must be specified when the data- 
base 1s created. This size limits the amount of data that may be 
stored in the database. A database may be expanded, though, 
if data storage requirements outgrow its initial capacity. 


There are two ways to expand a database: 


= Run the CCF utility to create a new database file; then run 
the SQL*Plus command ALTER PARTITION to add the 
new file to one of the database's partitions (normally SYS- 
TEM). ALTER PARTITION and CCF are discussed in the 
ORACLE Database Administrator's Guide, ALTER PARTI- 
TION 1s further described in the SOL* Plus Reference Guide. 


e Run the ORACLE command EXPAND to create a new da- 
tabase file and add it to the SYSTEM partition. EXPAND is 
described below. 
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EXPAND is similar in function to CCF followed by ALTER 
PARTITION, but: 


= [t performs morc extensive error checking, reducing the risk 
that you will make an error in the process of expanding the 
database. 


= [t can add a database file only to the partition SYSTEM. 
To run EXPAND: 


1. Make the current disk and directory the ones containing the 
ORACLE database files. This normally mcans 
C:\ORACLES\DBS. 


2. Run the ORACLE command: 
C> EXPAND USERID/password filename filesize 


where: userID is the user ID of a user with DBA authority. 
password is the password for userID. filename is the file name 
to be given to thc new database filc. You cannot change the size 
of an existing file; if you specify the name of an existing file, 
EXPAND will display an error message. filesize is the size the 
new file is to have, in DOS blocks (512 bytes cach). 


Performance Tuning 


The ORACLE Database Administrator's Guide describes tuning 
an ORACLE system for better performance. Read the portions 
of this guide that concern single-user systems 1f you wish to 
encourage application design for good performance. Various 
INIT.ORA parameters can affect your performance depending 
on your application. 


Auditing and Security of Database Objects 


While recording the use of a single-user computer is seldom 
necessary, ORACLE lets you do this if you wish. You can 
monitor successful and/or unsuccessful attempts to access ta- 
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bles, views, or synonyms; selectively audit different types of op- 
erations, such as updates only; and audit attempts to log on and 
to create user IDs. 


Security (access control) for tables, views, and columns is a 
more significant topic. Although only one person may use a 
single-user computer at a time, a computer and its database 
may still be shared by many users, making security an important 
feature of the ORACLE RDBMS. 


The ORACLE Database Administrator's Guide discusses audit- 
ing and security. 


Obtaining Information About the Database: The Data Dictionary 


ORACLE IN DOS 


The data dictionary is a set of tables and views automatically 
maintained by the ORACLE RDBMS. It records defined user 
IDs and their privileges, names and definitions of tables and 
other database objects, and other information. 


As a user, you can obtain information about the objects you 
own. As a DBA, you can obtain information about all users 
and their objects. 


The data dictionary is described morc fully in the ORACLE 
Database Administrator's Guide. The SQL* Plus User's Guide 
explains how to use SOL *Plus to examine information in se- 
veral of the data dictionary's tables and views. 


The following paragraphs discuss ways in which the ORACLE 
RDBMS in DOS differs from implementations of ORACLE in 
other environments. Similar sections in later chapters discuss 
ways in which the DOS version of each tool differs from imple- 
mentations of that tool in other environments. 


ORACLE in the PC/MS-DOS environment uses an ORACLE 
extension to DOS called the SOLPME, which stands for SQL 


Chapter 3. Administering Your System / 33 


Protected Mode Executive. SQLPME is invoked when you 
start ORACLE with the ORACLE command. SQLPME does 
NOT alter DOS in any way, but EXTENDS it to use the Pro- 
tected Mode of 286 and 386 processors in IBM AT and 100% 
compatible computers. The SQLPME uses the VDISK con- 
vention for signing wherc it is loaded in EXTENDED memory. 
Any utilities using EXTENDED memory that use this same 
convention are compatible with Professional ORACLE. Pro- 
grams that do not follow this convention may write over 
ORACLE and may not coexist compatibly. 


ORACLE keeps its own copy of the environment that was in 
effect when it was loaded. Any changes to that environment 
(using the DOS SET command) after SQLPME has been run 
will not be used by ORACLE. In order to change ORACLE 
parameters after the initial load, it is necessary to use 


REMORA to remove ORACLE, then reload it. 
Limits 


The ORACLE Database Administrator's Guide lists ORACLE 
limits. The MS-DOS version of ORACLE has no fixed limits 
more restrictive than those. There arc limits, however, to the 

values that some of ORACLE's opcrating parameters may use- 
fully have. Larger values make ORACLE consume extra re- 
sources (usually RAM) to no advantage. 


Several INIT parameters have maximum useful values. These 
are listed in Figure 3 on page 55. 


ADMINISTRATION TASKS; PROFESSIONAL AND NETWORKSTATION 
ORACLE 


The administration tasks in this section may be done by both 
Professional and Networkstation ORACLE users. 
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Backing Up and Restoring the Database: the EXP and IMP Utilities 


As the DBA, you should establish a regular schedule for data- 
base backup and restoration. Your schedule will depend on 
how frequently the database is updated and how critical its 
content is. A good rule to follow is, "if you wouldn't want to 
redo your work, back up your data." 


The ORACLE utility EXP (export) is used for database backup. 
EXP writes data from your ORACLE database to a DOS file. 
You restore your database with the ORACLE utility IMP (im- 


port). 


When you run EXP, you are prompted to give a filename for 
the export file. The default filename is EXPDAT.DMP'. If the 
file exceeds the space on the device, export will create additional 
files. Each subscquent file EXP creates is placed on the same 
device and given the same filename but a different file extension 
starting with '.001' up to '.999', You can accept the default 
filename and extension or override them and create the next 
export file on any device with any name you chose. This allows 
an export to thc hard disk to be continued on diskettes if the 
hard disk becomes full. 


IMP reads the files using the same naming scheme as EXP, and 
allows you to specify the name of the next file. If files are 


specified out of order, the usual symptom will be ‘abnormal end 
of file’. 


See the ORACLE Utilities User's Guide for information about 
the EXP and IMP programs. 


Customizing the Display and Keyboard: the CRT Utility 


ORACLE determines many of the characteristics of its display 
and keyboard interface by reading a CRT file. Some examples 
of characteristics controlled by the CRT file are type of display 
to be used, display mode (background color, color for regular 
text, etc.), and the keystroke sequences used to invoke various 
commands in ORACLE tools such as SQL*Forms. 
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For information about the CRT files that are distributed with 
ORACLE and how to modify or create a CRT file, see "Chapter 
4. Customizing Your Installation" on page 39 and the ORACLE 
Database Administrator's Guide. 


Loading Database Data from DOS Files: the ODL Utility 


When you want to use the ORACLE RDBMS to work with 
data that is available in a DOS file, you can load the data into 
the database with the ORACLE Data Loader (ODL) utility. 
ODL can load all data from a file or selectively load some of the 
data. Similarly, it can load a complete table or load only certain 
columns. The DOS version of ODL can handle either fixed re- 
cord length files or standard DOS text files. 


If the ODL data file has an extension of '.FIX', ODL will as- 
sume that all records in the file are exactly the same length 
(specified as the length in the ODL control file). The length 
includes any and all characters in the file. ODL will read the file 
as a binary file and not do any interpretation of newline, line 
feed, or carriage return characters. 


If the file is not of type '.FIX', ODL reads the file as a standard 
DOS text file. Records are delimited by carriage return/ line 
feed, so they may not appear as part of thc data in the file. 
Records need not be of the same length, but the “length” speci- 
fied in the ODL control file must be at least as large as the 
longest record in the file, including the two-character carriage 
return/ line feed record terminator. Records which are shorter 
than the specified length are padded with blanks by ODL, which 
will cause NULLs to be inserted in the database for those col- 
umns which arc all blank. 


The use of ODL. is discussed in detail in the ORACLE Utilities 
User's Guide. 
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GETTING ADDITIONAL HELP 


From time to time you may need the help of the Oracle Cor- 
poration Technical Support Department to solve problems that 
arise when using Professional or Networkstation ORACLE. 


If you call Technical Support for help, provide as much infor- 
mation as you can. Technical Support will want to know: 


= Your ORACLE registration number and your maintenance 
contract number 


=» The name and version number of the software presenting the 
problem 


a Details of your computer's hardware and software configura- 
tion 
= The text of any error messages that appear 


# Other symptoms of the problem 


a Information about your database, e.g., the number and size 
of your tables. 


You can greatly improve the chances of a quick solution if you 
attempt to isolate the problem. For example, if a statement fails 
in an application, test the statement alone in SOL*Plus. If a 
statement fails in a complex situation, test the statement in a 
simpler situation. 
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CHAPTER 4. CUSTOMIZING YOUR INSTALLATION 


The standard ORACLE system you installed in "Chapter 2. In- 
stalling ORACLE for the l'irst Time” on page 9 may suit your 
needs for a long time, particularly while you are lcarning 
ORACLE. However, you may eventually want to customize it 
-- modify its contents or opcrating parameters to suit your 
unique needs. This chapter explains how to do that. 


IMPORTANT DOCUMENTATION 


This chapter refers to thc following documents. You may wish 
to get access to these documents before you proceed: 


ORACLE Utilities User's Guide 
ORACLE Database Administrator's Guide 
SQL* Plus Reference Guide 


Technical Reference for the IBM Personal Computer, IBM 
order number 6025008 


Disk Operating System Technical Reference for the IBM Per- 
sonal Computer, IBM order number 6138536 


ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
contains up-to-the-minute information on installing and ad- 
ministering Professional ORACLE and Networkstation 
ORACLE. 
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CUSTOMIZING THE TERMINAL AND KEYBOARD 


This section applies to both Professional and Networkstation 
ORACLE. 


Some ORACLE tools determine characteristics of the display 
and keyboard interface by rcading a type of parameter file called 
a CRT file. 


Currently, the CRT file is used by SQLFORMS and 
RUNFORM (the SQL*Forms tools for the designer and oper- 
ator, respectively). SOL*Calc does not yet use the CRT file. 
This chapter describes thc way SQL *Calc will use the CRT file 
when support is implemented. 


The characteristics controlled by the CRT file are: 


a Type of display used (Monochrome Display, Enhanced 
Graphics Adapter, ctc.) 


" Display mode (background color, color for regular text, etc.) 


" Keystroke sequences used to invoke various commands in 
various ORACLE tools. 


ORACLE tools that use a CRT file normally use one named 
DEFAULT.CRT. You can direct such a tool to use a different 
CRT file by entering a command linc option when you run the 
tool. The appropriate command linc option is described in the 
document describing each tool. 


The ORACLE installation procedure creates DEFAULT.CRT 
by copying one of several distributed CRT files. You can copy 
a different CRT file to DEFAULT.CRT. 


All of the CRT files are kept in the ORACLE DBS directory 
(by default, \ORACLES\DBS). DEFAULT.CRT should be 
placed in the same directory. 
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Distributed CRT Files 


The CRT files distributed with the ORACLE RDBMS are de- 
scribed below. The SQL statements necessary to build them are 
also provided in similarly named files with extension .SQL (i.e., 


PCBIOS.SQL) 


These files are for a system that accepts IBM standard BIOS 
calls or memory mapped I/O for display control. 


NEWBIOS.CRT 


NUBLUBIO.CRT 


PCBIOS.CRT 


BWBIOS.CRT 


EGABIOS.CRT 


MONOBIOS.CRT 


This CRT definition uses a key defi- 
nition that may feel more familiar to the 
PC user than the other CRT definitions. 
Wherc most of the CRT definitions are 
similar to ORACLE version 4.1.4 key 
mapping, NEWBIOS tries to approxi- 
mate keys based on familiar PC key 
mapping. This CRT definition may be 
used with CGA and EGA monitors. 


For any color card with a color monitor. 
It will display a form using an all blue 
background using the same key defi- 
nitions as NEWBIOS.CRT. 


l'or a system with a Color Graphics 
Adapter (CGA) or cquivalent card and 
a color monitor. 


For a system with a Color Graphics 
Adapter (CGA) or equivalent card and 
a black-and-white monitor. 


l'or a system with an Enhanced Graph- 
ics Adapter (EGA) or equivalent card 
and a color monitor. 


For a system with a Monochrome Dis- 
play Adapter or equivalent card and a 
monochrome display. 
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BLUEBIOS.CRT 


43BIOS.CRT 


43DBIOS.CRT 


IADBIOS.CRT 


For any color card with a color monitor. 
It will display a form using an all blue 
background. 


43 line mode of enhanced graphics 
adapter for use with BIOS or VIDEO 
ORACLE TIO CONFIG.ORA param- 
cter. 


43 line mode of enhanced graphics 
adapter with different screen colors for 
SQL*Forms Designer; for use with the 
BIOS or VIDEO ORACLE TIO pa- 
rameter in CONFIG.ORA. 


l'or use by SOLFORMS in a system 
where DEFAULT.CRT is copied from 
PCBIOS.CRT. 


The following files are for a system that accepts ANSI escape 
sequences for display control (the default technique). 


PCANSI.CRT 


BWANSI.CRT 


EGAANSI.CRT 


MONOANSI.CRT 


IADANSI.CRT 


43ANSI.CRT 


l'or a system with a Color Graphics 
Adapter (CGA) or equivalent card and 
a color monitor. 


l'or a system with a Color Graphics 
Adapter (CGA) or equivalent card and 
a black-and-white monitor. 


l'or a system with an Enhanced Graph- 
ics Adapter (EGA) or equivalent card 
and a color monitor. 


For a system with a Monochrome Dis- 
play Adapter or equivalent card and a 
monochrome display. 


For use by SQLFORMS in a system 
where DEFAULT.CRT is copied from 
PCANSI.CRT. 


43 line mode of enhanced graphics 
adapter for use with ORACLE system 
default of ANSI. 
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SQL*Forms and CRT Files 


Screen Display Techniques 


Provided for the conversion of VMS 
VT100 forms to PC forms. 


VT100.CRT VMS VT100 CRT definition. 


The SQL*Forms tool has two major components that are in- 
voked by different DOS commands. Onc, SOLFORMS, is used 
by form designers. The other, RUNFORM, is used by opera- 
tors (who run forms). 


SOLFORMS uses its own default CRT file, named 
SOLFORMS.CRT. This CRT file has the same format and 
function as DEFAULT.CRT, but may contain different data, 
causing SOLFORMS to use a different set of colors to display 
screens on color monitors. 


When ORAINST is directed to copy PCBIOS.CRT or 
PCANSI.CRT to DEFAULT.CRT, it copies IADBIOS.CRT 
or IADANSI.CRT to SQLFORMS.CRT. When ORAINST is 
directed to copy any other CRT file to DEFAULT.CRT, it 
copics the same CRT file to SQLFORMS.CRT. 


ORACLE under DOS can use any of three techniques for dis- 
playing information on the screen: 


VIDEO ORACLE defaults to VIDEO when installed as this 
is the most efficient technique. It does require that 
your computer's display adapter card is 100% IBM 
compatible. Some non-IBM monochrome display 
adapters may not be compatible with video, and for 
them use BIOS instead. 


BIOS This technique is less efficient than VIDEO, but 
better than ANSI. It requires a DOS whose BIOS 
calls are compatible with PC-DOS. Most operating 
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systems that are compatible enough to run 
ORACLE support BIOS output. 


ANSI standard escape sequences 
This requires an ANSI dcvice driver (normally 
ANSI.SYS). 


You can select a display technique by changing the value of the 
CONFIG parameter ORACLE TIO, described in Appendix B. 


ORACLE must be run with a CRT file that is compatible with 
the display technique bcing used. Two groups of CRT files are 
distributed with ORACLE: 


# CRT files with “ANSI” in their names are compatible with the 
ANSI escape sequence technique. 


s» CRT files with "BIOS" in their names are compatible with 
both the VIDEO memory mapping technique and the BIOS 
call technique. 


Thus, if you use ORACLE TIO to specify display by BIOS calls 
or memory mapping, you must also copy one of the "BIOS" 
CRT files to DEFAULT.CRT. 


The value of ORACLE TIO may be changed at any log-on 
(i.e., any timc you start an ORACLE tool). Thus it is possible 
to run a tool using a specific display technique on a one-time 
basis. To do so, however, you must do both of the following 
things: 


l. Set ORACLE TIO to an appropriate value (e.g., with a 
command line parameter). 


2. Make the tool use an appropriate CRT file by specifying the 
file's name in an appropriate command line option. 


Creating Customized CRT Files 


If none of the distributed CRT files suits your needs, you can 
create one or more custom CRT files using the CRT utility, 
described in the ORACLE Database Administrator's Guide. 
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The CRT utility reads its input from a group of database tables. 
You must load these tables into the database. In the normal 
installed ORACLE system, thesc tables contain no data. You 
must fill them with data corresponding to one of the distributed 
CRT files before you can modify them. You can do this by 
running a SQL command file whose filename is the same as the 
filename of thc corresponding CRT file. l'or example, if you 
want to create a customized CRT file similar to PCANSI.CRT, 
you must first initialize the CRT tables by running a SQL 
command file named PCANSI.SQL. To do so: 


I. 
2. 


N 


Start ORACLE. 


Make \ORACLES\DBS the current directory (this is where 
both CRT files the SQL command files are kept). 


. Load SQL*Plus: 


C» SQLPLUS Username/Password 
At the SOLPLUS prompt, enter: 
SQL » START CRT 


. Then SQLPLUS will initialize the CRT tables and return you 


to the SQL prompt. 


The distributed files include SQL*Plus scripts corresponding 
to all of the CRT files listed in "Distributed CRT files” in this 
chapter except for IADANSI.CRT and IADBIOS.CRT. 


. Next, run the SQL script for the CRT definition you wish to 


load in the database: 
SQL > START NEWBIOS 


substituting the natne of the CRT definition that you wish to 
load. 
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CRT FORM 


CRT.INP and CRT.FRM are both provided to allow you to use 
RUNFORM to sce all the CRT tables and enter new informa- 
tion into them easily to create your own CRT. 


Customizing the Display 


ORACLE tools' display attributes are controlled by the table 
CRT. Each row in CRT defines display attributes for one dis- 
play mode. 


Most of the columns in CRT define display operations such as 
moving the cursor or clearing to end of line. The value in a 
column specifies the command code sequence that ORACLE 
will use to perform thc corresponding operation. 


The NAME column determines which display mode a row de- 
scribes. Its valuc may be any of the CRT definitions you loaded 
into the database, or a new name you choosc. To customize the 
display you should modify the row of the CRT which is closest 
to the custom you have in mind. 


You may modify thc following ficlds: 


ATTI the command code sequence that sets vidco attri- 
bute | (normally reverse video). SQL* Forms uses 
this attribute for entcrable fields. SOL*Calc does 
not use it. 


ATT2 the command code sequence that sets video attri- 
bute 2 (normally underlining). RUNFORM uses 
this attribute to highlight values in help screens. 
SQLFORMS (thc SQL* Forms designer's tool) and 
SOL*Calc do not use it. 


ATTI 2 thc command code sequence that sets video attri- 
butes I and 2 together. SQL*Forms uses this attri- 
bute for the message line. SOL*Calc does not use it. 


46 / ORACLE for IBM PC/MS-DOS Installation and User's Guide 


ATT1 3 the command code sequence that sets video attri- 
butes 1 and 3 together. SOL*Forms uses this attri- 
bute to control the display of an invalid field. 
SOL*Calc does not use it. 


CLEARSCREEN This command code sequence sets the screen 
display as it would look when starting SQL* Forms 
design. 


If you modify other fields, ORACLE tools may not function 
properly with the CRT file you produce. 


For ANSI display mode (i.e., NAME 7 'PCANSI), each field 
should contain the ANSI command codes for the desired dis- 
play attributes. ANSI command codes may be found in IBM's 
DOS Technical Reference. 


For BIOS or VIDEO display mode (i.e., NAME = 'NEWBIOS?, 
each field should contain the character sequence: 


Nel Nnnn 


where nnn is the one-byte attribute byte value for the desired 
combination of display attributes, expressed in octal. 


Attribute byte values for the Monochrome Display Adapter and 
the Color/Graphics Adapter (CGA) are described in IBM’s 
Technical Reference for the IBM Personal Computer. The attri- 
bute byte values for the Color/Graphics Adapter may also be 
used for the Enhanced Graphics Adapter (EGA). 


The following escape code sets the background color and is in- 
voked whenever the screen is cleared. It is intended to be used 
in the TSET (Terminal Setup in CRT.FRM) column of the 
CRT table in the database 


\eS\nnn 


where nnn is the one-byte attribute byte value for the desired 
combination of display attributes, expressed in octal. 
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Please note that this escape code will only work in BIOS and 
VIDEO mode, not in ANSI. Once this code is issued, it remains 
in effect until you exit RUNFORM or issue another. 
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Customizing the Keyboard 


ORACLE tools' keyboard definitions are controlled by the table 
ESC. Each row in ESC defines the function of one key for one 
ORACLE tool in onc of ORACLE's display modes. 


The PROD CODE column determines which ORACLE tool a 
row describes. Its value may be: 


IAP for RUNFORM (the form-running program for 
SQL*Forms) 


IAD for SQLFORM (the form-designing program for 
SOL*ľ Forms) 


NAME column corresponds to the name you want to give your 
CRT definition (e.g. NEWBIOS). To ensurc that the keyboard 
will function the same way in any display mode, you should 
make the same changes to both of a tool's sets of rows: the set 
in which NAME 7 'NEWANSTI' and in which 

NAME - NEWBIOS.. 


The FUNC column determines which program function a row 
describes. Its value is a two-character code. You may see what 
function cach code represents by selecting the row with the 

same PROD CODE and FUNC from the table FUNCTIONS. 


The ESCSEQ column specifies a character which, when entered 
through the keyboard, will cause the program specified by 
PROD_CODE to perform the function specified by FUNC. If 
a given function may be invoked by two or more keys, ESC may 
contain two or more pairs of records with the same value of 
FUNC and different values of ESCSEQ. 


Each ESCSEQ valuc may be specified in one of three formats: 


l. In ASCII. For example, 'R', for ANSI CRTs, may be speci- 
fied by the letter 'R'. 


2. As a backslash followed by a three-digit octal number. For 
example, [Return] may be specified by ‘\015’, for BIOS 
CRT's. 
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3. As ^ e' followed by a character (format 1) or an octal number 
(format 2) to represent a keyboard extended function. For 
example, the keyboard extended function code for the F6 key 
is decimal 64, ASCII '(3', octal 100; so the F6 key may be 
specified by ‘\e@’ or ‘\c\100’. Keyboard extended functions 
may be found in IBM’s Technical Reference for the Personal 
Computer, for BIOS CRTs. 


To modify the key assigned to one of the functions for one of 
the ORACLE tools: 


1. Use the table FUNCTIONS to find the proper value of 
FUNC for the function. 


2. Define the proper value of ESCSEQ for the appropriate key. 


3. Modify both records with the appropriate values of 
PROD CODE and FUNC in the table ESC. 


CUSTOMIZING THE DOS ENVIRONMENT: CONFIG PARAMETERS 


This section applies to both Prófessional and Networkstation 
ORACLE. 


CONFIG.ORA is a configuration file that is kept in the 
ORACLE home directory. It controls aspects of ORACLE's 
operation that are specifically related to DOS, such as the lo- 
cations of various ORACLE files in your computer's file system. 


Appendix B describes thc CONFIG paramcters and their de- 
fault values, and discusses which values you can change and 
why you might want to do so. 


When CONFIG Parameters Are Set 


ORACLE rescts its operating values for the CONFIG parame- 
ters whenever you: 


# Load and start ORACLE with the ORACLE command 
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" Run the IOR command 
a Start any ORACLE program or tool. 


Although all of the parameter values are resct at the times listed 
above, not all of them affect the operation of ORACLE when- 
ever they are changed. In fact, changes to most of the parame- 
ters can take effect only when ORACLE is started. Appendix 
B identifies the parameters that can usefully be changed at any 
time. 


How CONFIG Parameters Are Set 


ORACLE resets CONFIG parameters in a multi-step procedure 
that gives you a grcat deal of flexibility in controlling parameter 
values. 


In each step of the procedure, ORACLE sets CONFIG param- 
eter valucs from a particular source. In each step, it sets pa- 
rameter values that (1) are available from that source, and (2) 
were not set in an carlicr step. Thus, cach parameter is set from 
the first source that provides a value for it. 


The steps in the procedure take CONFIG parameter values 
from the following sources: 


1. The DOS command linc; for example: 
C» ORACLE/ORACLE_DBS=TESTDBS 


2. The file named by the DOS environment variable CONFIG. 


The default value of CONFIG is CONFIG.ORA in the di- 
rectory specified by the CONFIG parameter 

ORACLE HOME; the default value of ORACLE HOME is 
\ORACLES on the current drive. If the current drive is C:, 
the CONFIG file is thus C:\ORACLES\CONFIG.ORA. 
You can specify a different CONFIG file by storing the file’s 
path name in a DOS environment variable named CONFIG 
(use DOS’s SET command), or by using the CONFIG option 
on the command line (see step 1, above). If you do both, the 
command line option controls. 
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3. The default values are shown in Appendix B. Since a default 
value exists for every CONFIG parameter, ORACLE has a 
value for every parameter by the time it reaches the end of the 
procedure. 


Parameters that Refer to Other Parameters 


Some of the parameters in the CONFIG file have values that 
refer to directories. Such a parameter’s value may be defined to 
be the same as the current valuc of another CONFIG parame- 
ter. 


l'or example, the UTILITY MSG parameter specifies the name 
of the sub-directory: 


\%ORACLE_HOME%\%ORACLE_DBS%\ 


in the ORACLE home directory holding files that contain the 
text of error messages issucd by ORACLE tools and utilities. 


Certain INIT parameters refer to DOS path names, and may 
also be defined in terms of CONFIG parameters. For example, 
if you placed the following line in an INIT file: 


DATABASE = \TESTDB\4oracle_dbs%\DBS.ORA 


ORACLE's primary database file would be DBS.ORA, in the 
sub-directory named by the current (at start-up time) value of 
ORACLE DBS, in the directory \TESTDB. 


CHANGING DIRECTORY NAMES 


This section applies to both Professional and Networkstation 
ORACLE. 


When you install ORACLE for the first time, the installation 
procedure defaults ORACLE's "home directory,” to 
\ORACLES, and its sub-directories. 
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You can change ORACLE's home directory, provided you tell 
ORACLE what directory is the new home directory. You do 
this by changing the valuc of the CONFIG parameter 
ORACLE HOME. For example, to make the home directory 
\ORATEMP on the disk in drive D, you would have to set 


ORACLE HOME = D:NORATEMP 


This enables ORACLE to find the files in all of its sub- 
dircctories except DIN; for example, the database files in 
D:\ORATEMP\DBS, SOL*Calc files in D!\ORATEMP\CALC, 
etc. 


To enable ORACLE to find the files in the new BIN directory, 
you must include the directory in the DOS path. If the BIN di- 
rectory is DÀORATEMPYBIN, for example, you should place 

a PATH command like this one in your AUTOEXEC.BAT file: 


PATH C:N; D: NORATEMPNBIN 


(Note that you must specify the BIN directory's entire path 
name; the value of ORACLE HOME is not relevant. Always 
specify the directory name with a drive designator and a path 
namc that begins at the root.) 


You can also change the directory in which ORACLE looks for 
its database files (normally \ORACLES\DBS). The database 
files must be stored in a directory that is in the home directory; 
you must specify the namc of this directory with the CONFIG 
parameter ORACLE DBDS. For example, if the home directory 
is D:\ORATEMP and the database files arc in 
D:\ORATEMP\TESTDB, you would set: 


ORACLE DBS = TESTDB 
l'or information on how to set ORACLE IIOME and 


ORACLE DBS, see the preceding section, "Customizing the 
DOS Environment: CONFIG Parameters.” 
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CHANGING ORACLE STRUCTURES; PROFESSIONAL ORACLE ONLY 
The IOR Command 


The IOR command is used to initialize ORACLE (start it the 
very first time after installation) and to start and stop the 
ORACLE system. Sec the ORACLE Database Administrator's 
Guide for a complete description of the IOR command. The 
IOR I command is also invoked for you when you start 
ORACLE with the ORACLE command. 


The INIT File 


Every time you enter the IOR command, either explicitly or via 
the ORACLE command, ORACLE reads the INIT file (by de- 
fault, INIT.ORA) from the directory named by the CONFIG 
parameters ORACLE HOME and ORACLE DBS (by default, 
\ORACLES\DBS). 


The INIT file contains information that ORACLE uses to con- 
trol its internal structures and processes. Take some time to 
read about the file and its parameters in the ORACLE Database 
Administrator's Guide. 


The following figure lists the INIT parameters and identifies 
parameters that are used under DOS, or whose recommended 
(and default) valucs differ from the default values. 
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Value Set 
Parameter Default by INIT.ORA Notes 


Al BUFFERS Not used. 

AFTER IMAGE Not used. 

Al FILE SIZE Not used. 

AI WARN PCNT -- Not used. 

AUDIT TRAIL 0 (off) Scldom used. 

BEFORE IMAGE M/ooracle home%\“oracle_dbs%\BILORA 

BI BUFFERS 5 Do not change this value. 

BI HIGH 0 Do not change this value. 

BI LOW 0 Do not change this value. 

DLOCK SIZE 1024 Do not change this value. 

BUFFERS 50 Maximum useful value is 63. 

BUFF HASH BKTS 8 Do not change this valuc. 

CLUSTERS 20 

COLUMNS 350 

CONSOLE -- Not used. 

CONTEXT_INCR 4096 

CONTEXT_SIZE 4096 

DATABASE \Y oracle home%\“oracle_dbs%\DBS.ORA 

DETACHED DUMPS \“%oracle home%\“% oracle dbs% 

ENQUEUES 10 l No longcr used in MS-DOS version. 

FILES 5 Maximum is 16. 

FIXED DATE null 

INSTANCES 16 

INSTANCE NAME  - Not used. 

LANGUAGE -- Not used. 

OPEN CURSORS Only 1 is issued. 

OPEN LINKS 4 

PROCESSES 25 2 Minimum is 2. Any value over 2 
consumes space without yielding 
any benefit to MS-DOS. 


(continued) 





Figure 3. INIT Parameters 
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Value Set 
Parameter Default by INIT.ORA Notes 


READ REQUESTS Not uscd. 
READ BLKS TOT Not used. 
READ BLKS REQ -- Not used. 
SINGLE PROCESS Do not change this value. 
SORT AREA SZ 16384 Do not change this value. 
SORT FINAL RA I Do not change this value. 
SORT MERGE RA I Do not change this value. 
SORT POOL SZ Not used. 


SORT SPCMAP SZ 256 Do not change this value. 
2 


SORT READ FAC Do not change this value. 
SQL \Yoracle home%\“coracle_ dbs%\SQL.ORA 
TABLES 

TABLENAMES 80 

TABLE ACCESSES 24 

TABLE HANDLES 24 

TABLE_HSH_BKTS 4 

TEMP TABLES 2 

TRANSACTIONS 10 

USERINIT null 

USERS 30 

USER DUMPS M/ooracle home%\“%oracle_ dbs*/oY 





Figure 4. INIT Parameters (continued) 


If the standard DOS version of INIT.ORA gives a parameter a 
special value, do not delcte that parameter from INIT.ORA. If 
you do, ORACLE will use the default value listed in the 
ORACLE Database Administrator's Guide, and this may be in- 
appropriate. 
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Customizing the INIT Parameters 


You can customize the INIT parameters by changing them in 
INIT.ORA. Use a text editor such as EDLIN to change values. 
The syntax of cach parameter is: 


parameter value 


For example, to set the parameter OPEN CURSORS to 32, 
make the OPEN CURSORS line of INIT.ORA look like this: 


OPEN CURSORS 32 


You can also rename the INIT.ORA file or create multiple 
INIT files with different names. Thus you can create several 
different files defining difTerent configurations, then identify the 
file you want when you issuc the IOR command. 


To start ORACLE with an INIT file other than INIT.ORA, 
you must enter two commands. The first loads ORACLE with- 
out starting it, and the second starts it using a specified param- 
eter file: 


C» ORACLE /NOIOR 
C» IOR W PFILE=MYFILE 


The CONFIG parameters, described below and in "Appendix 
D. CONFIG Parameters and the CONFIG.ORA File” on page 
141, offer yet another way to invoke an INIT file. You can 
specify parameters for the LOR command, including the PFILE 
parameter, with the CONF'IG parameter IOR. 
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PART II: THE ORACLE TOOLS 


Part II: The ORACLE Tools / 59 
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CHAPTER 5. USING SQL*PLUS 


This chapter introduces SQL*Plus. It describes the available 
documentation, suggests an approach to Icarning SQL*Plus, 
and presents specific information about using SQL*Plus under 
DOS. 


IMPORTANT DOCUMENTATION 


The SQL*Plus documentation includes: 


SQL* Plus Relcase Notes -- contains information specific to 
the shipped version of SQL*Plus. Updates basic product in- 
formation. 


ORACLE for IBM PCIMS-DOS Installation and User's Guide 
(this guide) -- contains installation instructions and other in- 
formation specific to SQL*Plus under DOS. 


SQL* Plus User's Guide -- a comprchensive tutorial guide to 
SQL*Plus; contains examples and exercises. 


SQL* Plus Reference Guide -- a reference guide to SOL*Plus; 
contains complete descriptions of all SQL*Plus commands, 
functions, tables and vicws in the data dictionary, etc., in- 
cluding some items not mentioned in the SQL*Plus User's 
Guide. 


SQL* Plus Reference Card -- contains brief summary of refer- 
ence information for quick access. 
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WHAT IS SQL*PLUS? 


LEARNING SQL*PLUS 


e ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering SQL*Plus for Professional ORACLE and 
Networkstation ORACLE. 


SQL*Plus is a program that lets you manipulate an ORACLE 
databasc through a powerful fourth-gencration language. The 
SQL*Plus language is an extension to the SQL language sup- 
ported by many advanced database systems, including IBM's 

SQL/DS and DB2. 


Using SQL*Plus, you can: 

=" Create tables 

& Store, upate, and delete information in tables 

= Query table for information based on your own criteria 


s Define views that let you treat a cross-section of a table as 
though it were an independent table 


Perform calculations on information 


" Design and print reports. 


You can learn SQL*Plus on your own, using the demonstration 
tables along with the SOL*Plus tutorial guides. You can also 
attend a SQL*Plus class. We recommend that you do both. 


To attend a class, call your local Oracle office for a schedule of 
classes, dates, and locations. 


To learn SQL*Plus on your own: 
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l. Install the SQL*Plus demonstration tables (see the in- 
structions below). 


2. Read the SQL Primer to familiarize yourself with SQL, then 
continue with the SOL* Plus User's Guide. This thorough 
tutorial instructs you in using the SOL*Plus program. You 
learn as you perform examples on your computer. 


If the on-line help text 1s installed (recommended), you can en- 
ter the HELP command for information about SQL*Plus com- 
mands as you learn. 


ON-LINE HELP FACILITY 


If you did not copy and initialize Help when installing 
SOL*Plus, follow the instructions below. 


To load the IIclp tables into your local database, a .BAT file 
named HELPINS is provided. This .BAT file assumes you have 
not changed the SYSTEM account password, MANAGER. If 
you intend to install HIELP then you should do so prior to 
changing thc SYSTEM password. 


To load the Help tables, move to the \ORACLES\DBS direc- 
tory and run the ITELPINS program. Enter: 


CD \ORACLES\DBS <RETURN> 
HELPINS <RETURN> 


This starts the procedure that will load the help tables in your 


database. 


The SQL*Plus help facility provides on-line information about 
SQL*Plus commands and clauses. The syntax for cach com- 
mand, a description of its use, and examples are displayed by 
typing the command: 


SQL> HELP command 
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If you are using Professional ORACLE, you need to have in- 
stalled the help files during the installation process. Note that 
the help files require approximately 640K of disk space. If you 
are using Networkstation ORACLE, on-line help is automat- 
ically available to you from the remote database when you run 
SQL*Plus. You do not install it locally. 


BUILDING AND REMOVING THE SQL*PLUS DEMONSTRATION TABLES 


When the installation procedure loads the ORACLE RDBMS 
onto your fixed disk, it also loads .BAT files named DEMOBLD 
and DEMODROP. DEMOBLD builds copies of the SQL*Plus 
demonstration tables that are owned by a specified user ID; 
DEMODROP drops the tables. You will need these tables in 
the course of working through the tutorial in the SQL* Plus 
User's Guide. 


Building the Tables 


DEMORBLD builds some DOS files as well as ORACLE tables, 
and it places the files in the current directory of the current disk. 
l'or this reason it must be run in the directory in which you plan 
to work through the exercises in the SOL* Plus User's Guide. 


To build the demonstration tables, sct the appropriate current 
disk and directory, then enter the DOS command: 


C» DEMOBLD userid password 


where userid 1s the user ID you plan to use to work with the 
demonstration tables, and password is the password for that 
user ID. The SQL *Plus documentation refers to user ID 
‘SCOTT’ with password ‘TIGER’, but you may use any user ID 
and password. The user ID and password must be defined be- 
fore you use them, though. 


Since the demonstration tables are modified by the exercises in 
the SQL* Plus User's Guide, you must rebuild them when a new 
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Removing the Tables 


user begins using them, even if that user is using the same user 
ID as a previous one. You nced not remove the demonstration 
tables before rebuilding them; the DEMOBLD procedure itself 
will ensure that the tables are removed before they are restored. 


To remove the demonstration tables from the database, make 
the current directory the onc from which you built the demon- 
stration tables. Then enter the command: 


C» DEMODROP userid password 


where userid and password arc the user ID and password that 
you used when you built the tables. 


SPECIAL CHARACTERISTICS OF SQL*PLUS UNDER DOS 


The LOGIN.SQL File 


The following subsections describe aspects of SQL*Plus that are 
different when you usc SQL*Plus under DOS. They do not re- 
peat information that is in the generic SOL*PIus documenta- 
tion. 


The LOGIN.SQL file is an ASCII file containing one or more 
SQL*Plus commands. When you start SQL*Plus, it looks for 
this file in the current directory of the current disk. If it finds the 
file, it executes the commands contained in it. 


The LOGIN.SQL file is a convenient means of “customizing” 
SQL*Plus to fit your unique needs. If you want SQL*Plus’s 
EDIT command to invoke a particular text editor, for example, 
you can use the LOGIN.SQL file to initialize the variable 
_EDITOR to the text editor’s name. (This is discussed below, 
in the section titled "Editing.") 
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Since SQL*Plus looks for LOGIN.SQL in the current directory 
of the current disk, you can casily create several different 
LOGIN.SQL files for different applications or users. Simply 
store each file in a different sub-directory, and run each appli- 
cation (or instruct each user to run SQL*Plus applications) 
from the appropriate sub-directory. 


The ORACLE installation procedure places a standard 
LOGIN.SQL file in the home directory. You may make 
SQL*Plus use this file by running SQL*Plus from the home di- 
rectory; or you may place copies of the file in your usual work- 
ing directories, with or without modifications. 


Note that when the SQL*Plus demonstration tables are built, a 
special LOGIN.SQL file is built too. This LOGIN.SQL file 
contains commands that are necded to make some of the tuto- 
rial’s exercises work correctly. If a prior LOGIN.SQL file ex- 
isted, it is saved under another name; when the demonstration 
tables are dropped from the database, the prior LOGIN.SQL 
file is restored. 


Executing DOS Commands 


You can exccute any DOS command without leaving SQL*Plus 
by prefixing the command with the SQL*PLUS command 
HOST or $. For example, you can display a directory listing for 
drive A: with either of the commands: 


SQL> HOST DIR A: 
SQL> $ DIR A: 


Immediately after the command is executed, control returns to 
SQL*Plus (you receive the ‘SQL>’ prompt). 


If you type HOST with no command, you exit to DOS until you 
enter Exit to return to SQL*Plus. Be aware that external DOS 
commands (those that are stored in .COM or .EXE files) cannot 
be executed if there is not enough space in RAM. If you try to 
execute a command for which there is not enough space, you 
will get the usual error message from DOS. 
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Editing 


ORACLE for IBM PC/MS-DOS is a singlc-user system. If you 
attempt multiple logons ORACLE will allow the second logon, 
but your previous session will be rolled back and logged off. 
This is most likely to happen if you use the HOST command to 
load another ORACLE tool. 


Instead, you may want to use the OIIOST command. Unlike 
the HOST command, thc OIIOST command: 


= closes open cursors 
" logs you off from the database 


e runs the command specified by the OHOST command, and 
when command processing is completed, OHOST logs you 
back into the database (the cursors will still be closed). 


Please note that the IITOST command only runs the command 
specified by the HOST command. If the command performed 
an ORACLE logon, the caller is rolled back and logged off. 


You can edit a SQL*Plus command with your keyboard's 
function keys just as you would edit a DOS command linc. 


You can edit a DOS file containing a SQL*Plus command se- 
quence or other data with the standard SQL*Plus editing com- 
mands described in the SQL* Plus User's Guide and the 

SQL* Plus Reference Guide, or you can invoke a DOS text editor 
with the SOL*Plus EDIT command (provided there is enough 
space in memory for the editor of your choice) 


EDIT normally invokes thc standard DOS text editor, EDLIN. 
To make EDIT invoke a different text editor, assign the desired 
text editor's name to the user variable EDITOR. For example, 
to make EDIT invoke a text editor named MYWRITER, enter 
the SQL*Plus command: 


SQL> DEFINE EDITOR = 'MYWRITER' 


You can avoid having to enter this command each time you 
start SQL*Plus by placing it in your LOGIN.SQL file. 
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To make the text editor operate on the contents of the current 
buffer, enter EDIT with no parameters: 


SQL> EDIT 


When you finish and save the edited text, ORACLE places it 
back in the buffer. 


To edit the contents of a file, enter the command: 
SQL» EDIT filename 


If you do not specify an extension in the filename, EDIT as- 
sumes the extension '.SQL'. 


Spooling to the Printer 


The DOS version of SQL*Plus supports thc SPOOL command 
as described in the SQL* Plus Reference Guide. 


You can send displayed output to a spool file which you may 
print later using the command: 


SQL» SPOOL filename 


In addition, you can send displayed output directly to a printer 
by specifying the printer's DOS device namc instead of a file 
name. For cxample, to send displayed output to the printer at- 
tached to LPTI, enter: 


SQL> SPOOL LPT1 


Always be sure that your printer is loaded with paper and ready 
to print before you spool a file. If the printer is not ready, your 
computer may “freeze” until you ready the printer or restart 
DOS. 


You can also use PRN as a synonym for LPTI. 


Note that the SPOOL OFF command uses the 
ORACLE SPOOLER configuration parameter. If it invokes a 
print spool like the DOS PRINT command, make sure the 
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spooler is loaded by DOS before starting SQL*Plus. Otherwise, 
memory will be fragmented. See “Appendix B. CONFIG Pa- 
rameters and thc CONFIG.ORA Filc” on page 141 for more 
information. 
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CHAPTER 6. USING SQL*FORMS 


This chapter introduces SQL*Forms. It describes the available 
documentation and suggests an approach to learning 
SQL*Forms. In addition, it provides specific information about 
using SQL*Forms under the DOS operating system. 


IMPORTANT DOCUMENTATION 


The SQL*Forms documentation includes: 


SQL* Forms Release Notes -- contains information specific to 
the shipped version of SQL*Forms. Updates basic product 
information. 


ORACLE for IBM PC/MS-DOS Installation and User's Guide 
(this guide) -- contains installation instructions and informa- 
tion specific to SQL*Forms under DOS. 


ORACLE for IBM PC/MS-DOS System Release Bulletin -- 

may contain up-to-the-minute information on installing and 
administering SOL*F'orms with Professional ORACLE and 
Networkstation ORACLE. 


Introduction to SQL* l'orms -- introduces SQL* Forms 
through a quick, hands-on tour. l'or designers and operators. 


SQL* Forms Operator's Guide -- contains tutorial and refer- 
ence information on using forms to enter and retrieve data- 
base information. 
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WHAT IS SOL*FORMS? 


= SOL*Forms Designer's Tutorial -- contains tutorial informa- 
tion on designing forms. 


= SQL*Forms Designer's Reference -- contains reference infor- 
mation on designing forms. 


= SQL*Forms Operator's Reference Card -- contains compact 
reference information for the SQL*Forms operators. 


a SQL*Forms Designer's Reference Card -- contains compact 
reference information for the designers of forms. 


This chapter also refers to the following document. You may 
wish to get acccss to this document before you procced: 


" ORACLE Database Administrator's Guide 


SOL*Forms is an interactive tool that lets you design and use 
forms for thc entering and retricving database information. 


A “form” ts a computer display that resembles a printed form. 
It has fields analogous to the blanks in a form. You can use 
forms to enter information into the database by filling in forms, 
and display information from thc database by directing 
SQL*Forms to display forms filled in with information fetched 
from the database. 


SQL* Forms is designed for two basic types of users: 


= Operators, who use forms to enter and display database in- 
formation. 


= Designers, who create and modify forms using an interactive 
“screen painter” and a system of pop-up menus. 
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LEARNING SQL*FORMS 


You can learn SQL*Forms on your own, using the SQL*Forms 
demonstration tables along with tutorial guides, or you can at- 
tend classroom training. We recommend that you do both. 


To attend a class, call your local Oracle office for a schedule of 
classes, dates, and locations. 


To learn SQL*F'orms on your own: 


l. Install the SQL*Forms demonstration tables in the database 
(see the instructions below). 


2. Sit down at your computer with the booklet SOL* Forms 
Operator's Guide and follow its tutorial. 


3. If you want to design your own forms as well as use existing 
forms, continue with SQL*Forms Designer's Tutorial. 


BUILDING AND REMOVING THE SQL*FORMS DEMONSTRATION TABLES 


Building the Tables 


When the installation procedure loads thc ORACLE RDBMS 
onto your fixed disk, it also loads .BAT files named FORMBLD 
and FORMDROP. FORMBLD builds copies of the 
SQL*Forms demonstration tables which are owned by a speci- 
fied user ID; FORMDROP drops the tables. You will need 
these tables in the course of working through the tutorials in the 
SQL* Forms User's Guide and the SOL* Forms Designer's Tuto- 
rial. 


FORMBLD builds some DOS files as well as ORACLE tables, 
and it places the files in the current directory of the current disk. 
For this reason it must be run in the directory in which you plan 


Chapter 6. Using SOL*Forms / 73 


Removing the Tables 


to work through the exercises in the SQL* Forms User's Guide 
and the SQL* Forms Designer's Tutorial. 


To build the demonstration tables, make thc appropriate disk 
and directory the current ones, then enter the DOS command: 


C» FORMBLD userid password 


where userid is the user ID you plan to use to work with the 
demonstration tables, and password 1s the password for that 
user ID. The SQL*T'orms documentation refers to user ID 
‘SCOTT’ with password ‘TIGER’, but you may use any user ID 
and password. The user ID and password must be defined be- 
fore you use them, though. 


Since the demonstration tables are modified by the exercises in 
the SOL*Forms User's Guide and the SOL* Forms Designer's 
Tutorial, you must rebuild the tables when a new user begins 
using them, even if that user is using the same user ID as a 
previous one. You nced not remove the demonstration tables 
before rebuilding them; the FORMBLD procedure alone will 
restore the tables to their original state. 


To remove the demonstration tables from the database, make 
the current directory the one from which you built the demon- 
stration tables. Then enter the command: 


C> FORMDROP userid password 


where userid and password are the user ID and password that 
you used when you built the tables. 
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SQL*FORMS UNDER DOS 


Generate 


This section describes those aspects of SQL*Forms that are 
different when you use SQL*T'orms under DOS. It supplements 
general information that is available in the SOL*Forms doc- 
umentation. 


ORACLE for IBM PC/MS-DOS 1s a single-user system. If you 
attempt multiple logons ORACLE will allow the second logon, 
but your previous session will be rolled back and logged off. 
This is most likely to happen if you use the HOST command (in 
a trigger), to load another ORACLE tool. 


Instead, you may want to usc the OIIOST command. Unlike 
the HOST command, the OIIOST command: 


= closes open cursors 
" logs you off from thc database 


= runs the command specified by thc OIIOST command, and 
when command processing is completed, OHOST logs you 
back into the database (the cursors will still be closed). 


Please note that the HOST command only runs the command 
specified by the ITOST command. If the command performed 
an ORACLE logon, the caller is rolled back and logged off. 


When you GENERATE your form using SQL*Forms, only the 
INP file is generated. You must exit SQLFORMS and enter 
the DOS command: 


C» IAG formname - to 


where formname is the name of your form to complete the gen- 
erating of your form. 


JENERATE will produce an INP (input) file for the updated 
form. When you run [AG, it completes the conversion of the 
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INP file to a FRM file for RUNFORM to run. Doing this 
conversion at the operating system command line is a port ex- 
ception for PC/MS-DOS. Both types of files (and the [AG 
command) are described in more detail in the SQL* Forms De- 
signer's Reference. 


Large forms that allocate more than 64K of memory in a seg- 
ment will have to bc broken up duc to the Intel architecture 
limitation of 64K memory segments. These limits are described 
in Figure 9 of the ORACLE for PC/MS-DOS Installation and 
User's Guide. 
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RUNFORM 


With SQL*Forms under DOS you run the form from the DOS 
command line. To run a form, exit SQLFORMS and enter the 
DOS command: 


C» RUNFORM formname userID/password -options- 


where: 

" formname is the name of your form 

= userID is the user ID under which you want to run the form 
a password is that user ID's password 


= options are optional command line options. For example, you 
may specify 


C» RUNFORM ... -C MYCRT 


to specify that the CRT file MYCRT.CRT should be used 
instead of DEFAULT.CRT. 


SQL*Forms Key Assignments 


Figure 5 on page 78 shows the IBM PC/XT/AT keyboard keys 
that accomplish SQL* Forms's various form design functions 
using the PC ORACLE 4.1.4 compatible CRTs. Figure 6 on 
page 79 shows the keys that accomplish SQL*Forms's operator 
functions. 


Figure 7 on page 80 shows the IBM PC/XT/AT keyboard keys 
that accomplish SOL *TI'orms's various form design functions 
using the NEWBIOS CRT definition which is closely aligned 
with common PC usage. Figure 8 on page 81 shows the keys 
that accomplish SQL*Forms’s operator functions using the 
NEWBIOS CRT definition which is closely aligned with com- 
mon PC usage. 
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Function IBM Key 


General Functions 


Delete Character [Del] 

Delete Backward [Backspace] 
Insert/Replace [Ins] 

Move Down [Down Arrow] 
Move Left [Left Arrow] 
Move Right [Right Arrow] 
Move Up [Up Arrow] 
Next Field [Enter] or [Tab] 
Previous Field [Shift][Tab] 
Print [Shift] 9] 
Redisplay Screen [Shift] F8] 
Show Function Keys [F8] 


Functions Used in Windows 


Accept 

Clear Field 

Exit/Cancel [F3] 
Run-Options Window [Shift] 6] 
Select [Home] or [F1] 


Functions Used in the Screen Painter 


Accept [End] 

Create Field [F9] 

Cut [FS] or [Shift] F5] 
Define [F2] 

Draw Box/Line [PgUp] 
Exit/Cancel [F3] 

Paste [F4] 

Resize Field [F7] 

Select [Home] or [F1] 
Select Block [PgDn] 

Undo [F10] 





Figure S. Function Keys for SQL*Forms Designers (PC ORACLE 4.1.4 compatible) 
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Block Menu 
Clear Block 

Clear Field 

Clear Form/Rollback 
Clear Record 
Commit Transaction 
Count Query Hits 
Create Record 
Delete Dackward 
Delete Character 
Delete Record 
Display Error 
Duplicate Field 
Duplicate Record 
Enter Query 
Execute Query 
Exit/Cancel 

Help 
Insert/Replace 
List Field Values 
Move Left 


[Ctrl][HHome] 
[Shift][I^6] 


[Shift][F1] 
[F9] 
[Backspace] 
[Del] 
[Shift}[ FS] 
[Shift][F 10] 
[Shift] F7] 
[E7] 

[F1] 

[F2] 

[F3] 

[F10] 

[Ins] 

[F4] 

[Left Arrow] 


Move Right [Right Arrow] 
Next Block [PgDn] 

Next Field [Enter] or [Tab] 
Next Primary Key Field [Esc][ Tab] 

Next Record [Down Arrow] 
Next Set of Records . [Shift][F2] 
Previous Block [PgUp] 

Previous Field [Back][Tab] 
Previous Record [Up Arrow] 

Print [Shift] 9] 
Redisplay Page [Shift] F8] 

Scroll Left [Ctrl] Left Arrow] 
Scroll Right [Ctrl]| Right Arrow] 
Show Function Keys [F8] 





Figure 6. Function Keys for SQL*Forms Operators (PC ORACLE 4.1.4 compatible) 
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Function IBM Key 


General Functions 


Move Right [Right Arrow] 
Move Left [Left Arrow] 
Move Down [Down Arrow] 
Move Up [Up Arrow] 
Next Field [Enter] or [Tab] 
Previous Field [Back Tab] 
Insert/Replace [Ins] 

Delete Character [Del] 

Delete Backward [Backspace] 
Clear Field [Ctrl][End] 
Create Field [F3] 

Select [F2] 

Select Block [Shift]| F2] 
Define [F4] 

Resize Field [Shift][|F4] 
Cut [FS5][Shift]| 5] 
Paste [F6] 

Draw Box/Line [F7] 

Undo [F8] 

Accept [F10] 
Exit/Cancel [Shift] F10] 
Print [Shift] F8] 
Redisplay Screen [Shift]| F9] 
Run-Options Window [F9] 

Show Function Keys [F1] 


Figure 7. Function Keys for SQL*Forms Designers (NEWBIOS CRT) 
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Function IBM Key 


General Functions 


Move Right 
Move Left 
Next Field 


Next Primary Key Fld 


Next Record 

Next Set of Records 
Next Block 

Previous Field 
Previous Record 
Previous Block 
Insert/ Replace 
Delete Character 
Delete Backward 
Clear Field 

Clear Record 

Clear Block 

Clear Form/Rollback 
Delete Record 
Create Record 
Duplicate Field 
Duplicate Record 
Enter Query 

Count Query Hits 
Execute Query 
Commit Transaction 
Exit/Cancel 

Print 

Redisplay Page 
Help 

List Field Values 
Display Error 

Block Menu 

Show Function Keys 


[Right Arrow] 
[Left Arrow] 
[Enter] or [Tab] 
[Escape] or [Tab] 
[Down Arrow] 
[Ctrl][Pg Down] 
[Pg Down] 
[Back Tab] 

[Up Arrow] 

[Pg Up] 

[Insert] 

[Delete Key] 
[Backspace] 
[Ctrl- End] 
[Shift] FA] 
[Shift] 5] 
[Shift][F7] 
[Shift]| F6] 

[F6] 

[F3] 

[F4] 


[F7] 
[Shift J[8] 
F8 


[F10] 

[Ctrl-Z] or [Shift] F 10] 
[Shift] F8] 

[Shift][F9] 

[F2] 


[F9] 
[Shift][F1] 
[F5] 
[F1] 





Figure 8. Function Keys for SQL*Forms Operators (NEWBIOS CRT) 
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Names 


Limits 


You can change key assignments by changing the contents of 
the DEFAULT.CRT file. See "Chapter 4. Customizing Your 
Installation" on page 39 for information about this file. See the 
ORACLE Database Administrator's Guide for information about 
the CRT utility, which is used to create a customized CRT file. 


Since SQL*Forms stores forms in DOS files, form names must 
be well-formed DOS file names: they must consist only of the 
characters that arc valid in file names, etc. There are two ex- 
ceptions to this rule: 


a A name may be longer than eight characters, although the 
first eight characters of the name must be unique. 


= Form names may not contain filename extensions; for exam- 
ple, FORMNAME.XYZ is not a valid form name. 
SQL*Forms assigns thc extensions .INP and .FRM to dis- 
tinguish file types. 


IAG and RUNI'ORM impose some limitations in the MS-DOS 
environment, as shown in the following figure: 
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Element Maximum 


character string data 65535 bytes 
triggers 8190 
select statements 1560 


ranges 8190 

pages 8190 
boilerplate text 10922 bytes 
fields 564 

blocks 682 





Figure 9. IAG and RUNFORM Limits 


Note that these maximums may vary from release to release as 
the size of a single instance of each element is subject to change. 
When a form docs exceed onc of these limits, IAG will print an 
error message displaying the maximum that was exceeded. 


SQL*Forms Designer screen painter uses memory as needed 
when you are painting. If you are doing extensive screen edit- 
ing, it is recommended that you continually save your work so 
that none may bc lost should you run out of memory in the 
middle of an editing session. You can reclaim memory by exit- 
ing SQL*Forms Designer and reloading your Form. 
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CHAPTER 7. USING SQL*CALC 


This chapter introduces SQL*Calc. It describes the available 
documentation and suggests a way to learn SQL*Calc. In addi- 
tion, this chapter provides specific information about using 
SOL*Calc under DOS. 


IMPORTANT DOCUMENTATION 


The SQL*Calc documentation includes: 


ORACLE for IBM PC/MS-DOS, Installation and User's 
Guide (this guide) -- contains installation instructions and in- 
formation specific to SQL*Calc under DOS. 


ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering SQL*Calc using Professional ORACLE and 
Networkstation ORACLE. 


Introduction to SQL* Calc -- describes the features and bene- 
fits of SQL*Calc by example and shows SQL*Calc’s many 
similarities to Lotus 1-2-3. 


SQL* Calc User's Guide -- contains complete information on 
SQL *Calc. Includes a tutorial with examples and exercises 
and and reference sections. 


SQL* Calc Reference Card -- provides a compact description 
of SQL*Calc for quick reference. 


Chapter 7. Using SOL*Calc / 85 


WHAT IS SQL*CALC? 


LEARNING SQL*CALC 


This chapter also refers to the following document. You may 
wish to gct access to this document before you proceed: 


a ORACLE Database Administrator's Guide 


SQL *Calc is a spreadsheet program that is: 
= Command-similar with Lotus 1-2-3. 
# Integrated with ORACLE. 


As a spreadshect program, SQL*Calc does all the things you 
expect from an advanced spreadsheet program. You can input 
or copy data and formulas, perform calculations, do sophisti- 
cated projections and models, and produce reports. 


As an integrated spreadshcet program, SQL*Calc works with, 
the ORACLE RDBMS, allowing you to create database tables 
from sprcadshect data, pull database information into a 
spreadsheet, and move casily between database and spreadsheet. 


You can learn SQL*Calc on your own, using the demonstration 
database along with tutorial guides. 


To learn SQL*Cale: 


1. Sit down at your computer with the SOL*Calc User's Guide. 
This guide contains a tutorial that provides detailed instruc- 
tion. It teaches you to create a spreadsheet, enter text and 
numbers, entcr formulas, copy data, retrieve database data, 
use functions, format and print reports, sort, create a data- 
base table from spreadsheet data, and more. 
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2. If you are an experienced Lotus 1-2-3 user, read the Intro- 
duction to SQL* Calc for Lotus 1-2-3 Users for a comparison 
of Lotus 1-2-3 and SQL *Calc. 


BUILDING AND REMOVING THE SQL*CALC DEMONSTRATION TABLES 


Building the Tables 


When the installation procedure loads the ORACLE RDBMS 
onto your fixed disk, it also loads .DAT files named CALCBLD 
and CALCDROP. CALCBLD builds copies of the SQL *Calc 
demonstration tables which are owned by a specified user ID; 
CALCDROP drops thc tables. You will need these tables in the 
course of working through the tutorials in the SOL* Calc User's 
Guide. 


To build the demonstration tables, enter the DOS command: 
C» CALCBLD userid password 


where userid is the user ID you plan to usc to work with the 
demonstration tables, and password 1s the password for that 
user ID. The SQL*Calc documentation refers to user ID 
‘SCOTT’ with password "TIGER', but you may use any user ID 
and password. The user ID and password must be defined be- 
fore you use them, though. 


Since the demonstration tables are modified by the exercises in 
the SQL* Calc User's Guide, you must rebuild the tables when 
a new user begins using them, even if that user is using the same 
user [D as a previous onc. You need not remove the demon- 
stration tables before rebuilding them; the CALCBLD proce- 
dure alone will restore the tables to their original state. 
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SQL*CALC UNDER DOS 


The following subsections describe those aspects of SOL*Calc 
that are different when you use SQL*Calc under DOS. It sup- 
plements the general information that is available in the 
SOL*Calc documentation. 


Executing DOS Commands 


The SQL*Calc /File Utilities command lets you perform oper- 
ations equivalent to thc DOS commands DIR, COPY, ERASE, 
and CD (Change Directory). 


The /File Utilities command prompts you for one of the fol- 
lowing subcommands (described in the SQL*Calc User's 
Guide): 


List (equivalent to DIR) 

Copy (equivalent to COPY) 
Erase (equivalent to ERASE) 
Set Directory (equivalent to CD) 


You must observe DOS file naming conventions when you refer 
to files in the /List, /Copy, and /Erase commands. For example, 
you must limit file names to cight characters (plus a three- 
character filename extension), and you must enter drive names 
and pathnames (if any) in the usual DOS format. 


You may use DOS wildcard characters (?' and '*') to indicate 
groups of file names in the /List and /Erase commands. 


SOL*Calc Key Assignments 


Figure 10 on page 89 shows the keys on the IBM PC/XT/AT 
keyboard that perform specific SOL*Calc functions. 
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IBM Key 


[FT] 
[F2] 


[F2], [Return] 


[F3] 
[F5] 


[F6] 
[F7] 


[F8] 
[F9] 


[F10] 
[PgUp] 
[PgDn] 
[Ins] 
[Del] 


[Home] 


[End] 


SQL*Calc 


Help 
Edit 
Edit, Return 


Name 
GoTo 


Window 
Query 


Table 
Calc 


*Copied* 


PageUp 
PageDown 
Insert 
Delete 


Home 


End 


Figure 10. SQL*Calc Function Keys 


Function 


Get context-specific help. 

Place content of current cell 

on the input line for editing. 
Re-executes SQL 

statement in current cell. 

List directory of *.CAL files. 
Get prompt for cell coordinate 
or name. 

Switch to second of dual windows. 
Executes all Select SQL 
statements on spreadshect. 

List all your database tables. 
Recalculates spreadshcet 
formulas and updates display. 
Executes all copied SQL 
statements in all cells. 

Show previous window of rows. 
Show next window of rows. 
Toggles character insert and 
character overwrite (Editing). 
Delctes the character over the 
cursor (Editing). 

Move to cell Al or, when 
editing, to beginning of the line. 
Move to cell at the highest 

row and column coordinate or, 
when editing, to the end of the line. 


(continued) 
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IBM Key SQL*Calc Function 


[Enter] Return Enter data. 
[Backspace] Backspace Erase character to left. 
[Esc] Escape Cancel command, erase data. 
[Up Arrow] Up Arrow Move the cursor up one cell. 
[Down Arrow] Down Arrow Move the cursor down one cell. 
[Left Arrow] Left Arrow Move the cursor left one cell 
or, when editing, left one character. 
[Right Arrow] Right Arrow Move the cursor right one 
cell, or when editing, right one character. 
[Ctrl][Z] Exit Return to DOS without saving 
current spreadsheet. 
[Ctrl]][D] Right Arrow Move the cursor right one cell. 
[Ctrl][S] Left Arrow Move the cursor left one cell. 
[Ctrl] E] Up Arrow Move the cursor up one cell. 
[Ctrl][X] Down Arrow Move the cursor down onec cell. 





Figure 11. SQL *Calc Function Keys (continued) 


Names 


SOL*Calc stores spreadsheets in DOS files, using the filename 
extension .CAL. It uses the extension .PRN for print files. Since 
extensions are used by SOL *Calc to list files with the Name key 
or the utility List, we recommend you not change SQL *Calc file 
extensions. 


Display Attributes 


SQL*Calc currently does not use a CRT file to determine its 
display attributes. Display attributes are fixed. 
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Printing 


Make sure that your printer is loaded with paper and ready for 
use before you begin a /Print operation. If your printer is not 
connected, your computer will “freeze” until you make the con- 
nection. 


If you start a /Print operation and then find that you cannot 
connect the printer, you will be unable to end the operation; 
thus you will not be able to save your data. 


Mouse Definitions For Microsoft/Mouse Systems: 


We have provided simple mouse definitions for the Microsoft 
and Mouse Systems products. To use the mouse, you must 
create a Mouse Menu using our definitions and the software 
provided with your mouse. 


Mouse Definition File (Installed in /ORACLES/CALC): 
Mouse Systems Mouse | Microsoft Mouse 


a. av ae «na» emp umm un use =o ee ee an aw ao USD ar am o oo uo om am M———————————————————————— 


M CALC.MSC | SQLCALC. DEF 


To gencrate the mouse definition (do this one time only using 
the indicated program supplied by your mouse manufacturer): 


Mouse Systems Mouse | Microsoft Mouse 

e «— X m we o au — ee ee w—— we we we we ee ee ee — am fw em wm wm wm mn wm nm wm ew em nw em em wm em ene 

MSC M CALC MAKEMENU [RETURN] 
SQLCALC 


Each time you boot: 
Mouse Systems Mouse | Microsoft Mouse 


e ee a ee w— e wu we om we ee ee we we we "— — — — "—À — ae 4T———————————————————————— 


MOUSESYS | MOUSE 
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Then to use SQL*Calc: 


Mouse Systems Mouse | Microsoft Mouse 
=~ a oe oe om an que uu» ap oe GER oe om oe oe oe ow oe am we oe = cum 4M—————————————————————————— 


M CALC | MENU SQLCALC 


Mouse movement is translated into cursor movement. Buttons 
do the following: 


Select command choice 
([Return] key) 


Left Button 








eu a eu um» Que «se we UP GNO GAP UND GEM Ge Gu ao oe "ED CUP Gum am am on am MEF——————————————————————————- 
Right Button Select range 

(same as period key) 
a e eu» Gu» am Gu» am oe em av Cue am ar ar aw =m use =n uem am ce om am ap M—————————————————————————— 
Middle of Mouse Systems Invoke command menu 
or (1st press) 
both Microsoft buttons Cancel command menu 


(2nd press) 
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CHAPTER 8. USING SQL*NET 


This chapter introduces SQL*Net. It describes the available 
documentation and suggests an approach to learning SQL*Net. 
In addition, this chapter provides specific information about 
using SQL*Net under DOS. 


IMPORTANT DOCUMENTATION 


The SQL*Net documentation includes: 


SQL* Net Release Notes -- contains information specific to 
the shipped version of SQL*Net. Updates basic product in- 
formation. 


ORACLE for IBM PC/MS-DOS Installation and User's Guide 
(this guide) -- contains installation instructions and informa- 
tion specific to SQL*Net under DOS. 


ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering SQL*Net using Professional ORACLE and 
Networkstation ORACLE. 


SQL* Net User's Guide -- contains complete information on 
SOL*Net. It describes the protocols provided with SQL* Net 
and the syntax for each. 
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WHAT IS SQL*NET? 


LEARNING SQL*NET 


SQL*Net is a tool that enables you to use the ORACLE 
RDBMS as a distributed database system. If your personal 
computer is connected to a network or modem, SOL*Net lets 
you use other ORACLE tools on your computer to work with 
ORACLE databases located remotely (on other computers). 


SQL*Net 1s a component of Networkstation ORACLE, which 
is designed to work only with remote databases. SQL*Net may 
also be purchased as an optional tool for use with Professional 
ORACLE, enabling ORACLE to work with remote databases 

as well as its own, local databasc. 


SQL*Net is essentially transparent. That 1s, there is little differ- 
ence between the way you work through SQL*Net with infor- 
mation stored remotely and the way you would work directly 
with the same information if it were stored on your own com- 
puter. All of ORACLE's other tools, such as SQL*Calc and 
SQL*Forms, may be used with a remote database through 
SOL*Net. 


To learn SQL*Nct, read selected parts of the SOL* Net User's 
Guide. That guide contains the basic information that you need 
to get started with SQL*Net, as well as reference information 
that you may usc while you work with SOL*Net. 


Read chapters 1 through 3, which will introduce you to the 
concepts of SQL*Net and basics of using it. Read the remaining 
chapters that apply to the protocol that your computer uses to 
communicate with the remote database. 
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SQL*NET UNDER MS-DOS 


The following subsections describe those aspects of SQL*Net 
that are different when you use SQL*Net under MS-DOS. It 
supplements the general information that is available in the 
SQL*Net documentation. 


SQL*Net Drivers 


SQL* Net uses software called drivers to communicate with host 
computers. Different protocols require different drivers. 


SQL* Net drivers that are available in MS-DOS are listed in the 
following figure. Later sections of this chapter give more de- 
tailed information about specific drivers. 


Note that in MS-DOS, SQL*Net drivers must be explicitly 
loaded into memory. You do this by running the MS-DOS 
commands shown in the following table. 


DOS Command 
Prefix Protocol & Medium to Load 


Single task None; for using the C» SQLPME 
local database 


Asynchronous A: ORACLE Asynchronous C» SOLASYNC 
Protocol (modem or cable) 


DECnet D: DECnet over 3Com or C> SOLDNT 
MICOM Ethernct cards 


Figure 12. SQL*Net Drivers in DOS 
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Specifying a Driver and Driver Parameters 


In order to use SOL*Net, you must specify a set of communi- 
cations driver parameters. You may do this either as defaults, 

when you set up the CONFIG file, or explicitly, when you run 
an ORACLE tool or a SOL*Net command. 


The formats and meanings of the SQL*Net parameters you 
must specify depend on the driver you are using, but are not 
specific to MS-DOS. They are described in the SOL* Ner Re- 
lease Notes. 


The communications driver and parameters SQL* Net will use 

are determined when you start an ORACLE tool or other pro- 
gram that is to communicate with a remote database through 

SQL* Net. SQL*Net determines these items as follows: 


|. If you specify a driver prefix and one or more parameters in 
your log-on specification, SQL*Net uses those. SQL*Net as- 
signs default values to any paramcters you omit. 


For example, if you enter the command: 
C» SQLPLUS SCOTT/TIGERGA: COM1,9600,N,8,0:,1: 


SQL*Net will use the asynchronous communications driver 
with the driver parameters COM 1,9600,N,8,0:,1:". 


2. If you specify a driver prefix with no parameters with your 
log-on specification, SQL*Net uses that driver. If the driver 
prefix matches the one in the CONFIG parameter REMOTE, 
SQL*Net uses the driver parameters specified by REMOTE; 
if not, SQL*Net assigns default values to all parameters. 


For example, if you enter the command: 

C» SQLPLUS SCOTT/TIGERGA: 
and the value REMOTE begins with 'A:...', SOL*Net will use 
the asynchronous driver with the driver parameters specified 


by REMOTE. See Appendix B for more information about 
the REMOTE CONFIG parameter. 
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Single-Task Driver 


Asynchronous Protocol 


3. If you specify no driver prefix as a part of your log-on spec- 
ification, SQL*Net uses the driver and driver parameters 
specified by the CONFIG parameter LOCAL. See Appendix 
B for for more information about the LOCAL CONFIG pa- 
rameter. 


The single-task driver is actually no driver at all -- it is 
ORACLE 's local database (i.e., the database on the computer 
where the ORACLE RDBMS is running). Thus, specifying the 
driver prefix ’S:’ accesses the local database. 


The single-task driver is meaningful only for Professional 
ORACLE, since Networkstation ORACLE cannot have a local 
database. 


The asynchronous driver communicates with a host computer 
through one of the following media: 


= A serial port and a cable 

= A serial port and an external asynchronous modem 
a An internal asynchronous modem 

The asynchronous driver requires 71 Kb of RAM. 


The amount of RAM used for communication buffers and sim- 
ilar purposes is controlled by the CONFIG parameter 
ASYNC_MEMORY. The value of this parameter determines 
the number of kilobytes (Kb) of RAM that will be used. The 
default amount 1s 12 (12 Kb); the driver’s total RAM require- 
ment of 71 Kb includes this default amount. 


The driver supports modems that conform to the command 
code standards defined by Hayes Microcomputer Products, Inc., 
including but not limited to the following: 
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# Hayes Smartmodem models 1200, 1200B, 2400, and 2400B 
a Case Rixon 2400 
a Microcom models SX/1200 and SX/2400 


To use SQOL*Net for communication over asynchronous lines, 
you must first dctermine how you will be communicating: 


hardwired direct to IITOST 


direct to Host via a port sclector 
MODEM direct to HOST 
MODEM to HOST via port selector 


Next make sure you have the necessary connection. Test your 
conncction by using a third party communication program to 
establish the connection first. Edit your CONFIG.ORA file. 


The changes you make depend on whether you will use 
Networkstation ORACLE for distributed processing against a 
remote database, or Professional ORACLE with SQL*Net for 
a distributed database. 


Depending on the type of async connection you are making, 
you may usc the sample CONFIG and dialogue files provided. 
(Your actual async connection may dictate further customizing 
of these dialogue scripts. Refer to the SOL*Net User's Guide 
section entitled "Using the Asynchronous Protocol.) 


The sample CONFIG files for Asynchronous SQL*Net arc: 
CONFIG.IIW9 - hardwired direct to HOST 9600 baud 
CONFIG.DX?9 - direct to Host via a port selector 9600 


baud 
CONFIG.HID - MODEM to HOST via port selector 1200 
baud 
CONFIG.II2D - MODEM to HOST via port selector 2400 
baud 
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Configuring for Networkstation ORACLE: 


For Networkstation ORACLE, you must edit your 
CONFIG.ORA file in the format of the sample file 
CONFIG.H2D, adding the LOCAL = parameter as described 
below. 


OCAL=A: com1,2400,n,8,0:,1,, 3: \ORACLES\NET\HDCX , USERNAME , PASSWORD, 5552400 


DRACLE_TIO=VIDEO 





In this example, the symbol A: tells ORACLE you are using 
Async for SQL*Net to communicate; Coml is the serial port 
you will be using. You arc using 2400 baud with no parity, 8 
bits, and no stop bits. The ^,1^ parameter after the basic com- 
munications parameters tells SQL*Net that you want to run in 
line mode (for most of your communication with Async 
SOL*Net you will use line mode). 


The next parameter after the ^,1,," is 3; this tells SQL*Net to 
set the log flag on. This logs autologon messages to a log file 
and writes them to the screen whilc initiating the logon. It isa 
good idea to initially set the log flag to 3 when your are making 
your first attempts at using Async SQL*Net. This way, you can 
watch the autologon process to sce where it might be failing. 


The entry \ORACLES\NET\HDCX tells SQL*Net the prefix 
of your dialogue files. USERNAME,PASSWORD is a valid 
system account and password, and 5552400 is the phone num- 
ber you will use to dial out. 


You maintain the ORACLE TIO- paramcter to use the CRT 
definitions installed as defaults. 


Configuring for Professional ORACLE with SQL*Net: 


To run Professional ORACLE with SQL*Net, you must edit 
your CONFIG.ORA file differently. Instead of having the 
LOCAL  paramcter point to A: (your remote Async-accessible 
RDBMS), you must have it point to S: (your locally resident 
RDBMS kernel). [n addition, you must add the new parameter 
REMOTE= to point to the remote database. 
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NOTE: The S: designation comes from the VMS Single task 
RDBMS. 


REMOTE=A: com1, 2400, n,8,0:, 1, , 3: \ORACLES\NET\HDCX , USERNAME , PASSWORD, 5552400 


ORACLE TIO-VIDEO 





Here, the values for the A: string arc the same as described 
above for Networkstation ORACLE. Again, you maintain the 
ORACLE TIO - paramcter to usc the CRT definitions in- 
stalled as defaults. You now must establish your connection 
using the Async autologon scripts in your dialogue files. 


The HDCX files in your \ORACLES\NET directory are the 
scripts which correspond to the sample CONFIG file presented 
above. Creating autologon scripts is described in greater detail 
in the SOL* Net User's Guide. If you have difficulty creating an 
autologon script that will log you in, you can debug your script 
using ALX (the Autologon Exercisc). This is described in Ap- 
pendix A of the SOL* Net User's Guide. 


Now load SQLASYNC, the SQL*Net Asynchronous driver. 


Executing Networkstation ORACLE: At the DOS prompt, en- 
ter SQLASYNC and press RETURN. This loads the SQL*Net 
Asynch driver. 


Executing Professional ORACLE with SQL*Net: You must 
first load ORACLE. At the DOS prompt, enter ORACLE and 
press RETURN. Then load the Asynch driver: enter 
SQLASYNC and press RETURN. This loads both the 
SOL*Net driver and its protected mode extension. 


At this point using SOL*Nct is transparent to you as a user. 
Follow the documentation for any of the ORACLE tools on 
how to conncct to ORACLE. Whether you work against a lo- 
cal database on your machine or a "local" database that is over 
Asynch it is completely transparent to the tool. For example, 
you may enter: SOLPLUS USERID/PASSWORD (where 
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SQL*Net Sample Files 


USERID/PASSWORD is a valid ORACLE userid and pass- 
word). 


The SQL*Net asynchronous device driver is supplied with a 
varicty of example files to guide you in constructing your own 
custom installation. In addition to the example “dialogue” files 
describing timing, retry, and control codes needed to automate 
the logging on to a host computer, there are also the following 
examples: 


a Three MS/DOS batch files named CALLUP.BAT, 
STAYUP.BAT, and HANGUP.BAT in the BIN sub- 
directory. 


a Three CONFIG files named CALLUP, STAYUP, and 
HANGUP in the NET sub-directory. 


You need not copy these CONFIG files to the default 
CONFIG.ORA file in the home ORACLE directory. In fact, 
you may wish to have the CONF IG.ORA file in the home di- 
rectory sct for use of your local PC database; you can reference 
these SOL*Net files whenever you wish to switch to a host 
computer's database. When you want to work with PC data, 
CONFIG.ORA is referenced. When you want to work with 
host computer data, you can instead reference the CONFIG 
files in the NET sub-directory (using the DOS SET command). 


The files CALLUP.BAT, STAYUP.BAT, and HANGUP.BAT 
perform the DOS SET command as a convenience. All you 
need to do is enter C> CALLUP, etc. 


Three such files are provided in order to take advantage of the 
flexibility of SQL*Net. Depending on the parameters specified 
by the CONFIG file, SOL*Net can optionally connect to a host 
(using a modem if needed), disconnect from a host (hanging up 
the phone linc), or both. The default behavior of SOL*Net is 
to connect to the host at the beginnning of an ORACLE appli- 
cation program and disconnect when the program terminates. 
The three sample files are designed for the user who wishes to 
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DECnet Protocol 


remain connected to the host while going from one ORACLE 
application to another. 


Consider the following hypothethical PC session: 


C» CALLUP 
C» SQLPLUS 
C» STAYUP 

C» SQLFORMS 
C» RUNFORM 
C» HANGUP 

C» SQLCALC 


Here, the CALLUP .BAT file points to thc CALLUP config file 
with the necessary parameters to (phone and) connect and log 

in to a host computer. When SQLPLUS is run the connection 
occurs; when SQL*Plus is exited, the connection remains intact. 


The STAYUP .BAT file points to the STAYUP config file, 
which does not request the connection to be performed. This 
config file remains active while the user goes in and out of se- 
veral ORACLE applications. 


Prior to the last ORACLE application, the user runs the 
IIANGUP .BAT file to point to the HANGUP configuration 
file that specifies disconnect upon completion of the upcoming 
ORACLE applcation. When SQLCALC is exited the con- 
nection is broken. 


To take advantage of these sample config files, you must edit 
CALLUP STAYUP and IIANGUP to include the correct 
username, password, speed, port and prefix name of the corre- 
sponding dialogue files that are need to properly specify the A: 
paramater list. You must also preparc the dialogue files as de- 
scribed in the SQL*Net documentation. 


The DECnet driver uses DECnet protocol to communicate with 
a host over an Ethernet local area network. The local computer 
must be connected to the network with a 3Com or MICOM 
Ethernet controller. 
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Before you can start the DECnet driver, you must start two 
DECnet-DOS programs: 


" DNPETHPC 


= DLL3COM (for a 3COM controller) or DLLMICOM (for a 
MICOM controller) 


These programs are available from Digital Equipment Corpo- 
ration (DEC), and are discussed in the DE Cnet-DOS Installation 
Guide, DEC publication AA-ET20B-TV. 


The DECnet driver requires 55 Kb of RAM to run in addition 
to whatever DECnet DOS requires. 


The amount of RAM used for communication buffers and sim- 
ilar purposes is controlled by the CONFIG parameter 

SOC MEMORY. Thc value of this parameter determines the 
number of kilobytes (Kb) of RAM that will be used. The default 
amount is 12 (12 Kb); the driver's total RAM requirement of 
55 Kb includes this default amount. 


Use the following procedure to set up SQL*Net for communi- 
cation via the DECnet protocol. 


NOTE: This procedure assumes that you have successfully in- 
stalled the necessary third party DECnet DOS software and the 
third party Ethernet card hardware from 3Com or MICOM. 


1. Test your Ethernet connectivity to the remote host by using 
the DECNet DOS command SETHOST NODENUMBER. 


The NODENUMBER parameter, available from your net- 
work administrator, is the DECNet node number of the host 
to which you want to connect. If you are properly connected 
via DECNet DOS you will be able to log in to the remote 
host. If you cannot connect, contact your network adminis- 
trator before proceeding. The network administrator can en- 
sure that you have the ability to connect. 


2. Next, edit your CONFIG.ORA file. 


The changes you make depend on whether you will use 
Networkstation ORACLE for distributed processing against 
a remote database, or Professional ORACLE with SQL* Net 
for a distributed database. 
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If desired, you can maintain separate CONFIG files which 
contain difTerent parameters; you can invoke the proper file 
at the time you load your SQL*Net driver. (These files need 
not have the file name CONFIG.) 


To invoke a particular CONFIG file, set the DOS environ- 
ment variable to point to it. At the DOS prompt, enter: 


SET CONFIG=\PATHNAME\FILENAME [RETURN] 


Networkstation ORACLE: 


For Networkstation ORACLE, you must edit your 
CONFIG.ORA file in the format of the sample file 
CONFIG.DNT, adding the LOCAL - parameter as de- 
scribed below. 


LOCAL-D: 1. 5"USER PASSWORD": : " TASKGDNTSRV" 
ORACLE TIO-VIDEO 


In this example, the symbol D: tells ORACLE you are using 
DECnet for SQL*Net to communicate; 1.5 is the DECnet 
node number. (You should get thc appropriate node number 
from your network administrator.) USER PASSWORD isa 
valid VMS account and password. 


DNTSRYV is the command file on the remote DECnet node 
which is invoked on connection. This command file runs the 
SQL* Net server image (see Chapter 5 of the SOL* Net User's 
Guide, Version 5.1). Make surc that DNTSRV.COM is in the 
VAX account that you are connecting to. This .COM file is 
provided with your DECnet SQL *Net server software. 


You maintain the ORACLE. TIO- parameter to use the 
CRT definitions installed as defaults. 


Professional ORACLE with SQL*Net: 


To run Professional ORACLE with SQL*Net, you must edit 
your CONFIG.ORA file differently. Instead of having the 
LOCAL- parameter point to D: (your remote 
DECnet-accessible RDBMS), you must have it point to S: 
(your locally resident RDBMS kernel). In addition, you must 
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add the new parameter REMOTE = to point to the remote 
database. 


NOTE: The S: designation comes from the VMS Single task 
RDBMS. 


LOCAL=S: 
REMOTE=D:1.5"USER PASSWORD": : " TASKGDNTSRV" 
ORACLE TIO-VIDEO 


Here, the values for the D: string are the same as described 
above for Networkstation ORACLE. Again, you maintain 
the ORACLE TIO - parameter to use the CRT definitions 
installed as defaults. 


. You must next load SQLDNT, the SQL*Net DECnet driver. 


Networkstation ORACLE: 


At the DOS prompt, enter SOLDNT and press -RETURN-. 
This loads the SQL*Net DECnet driver. 


Professional ORACLE with SQL*Net: 


You must first load ORACLE. At the DOS prompt, enter 
ORACLE and press [RETURN]. Then load the DECnet 

driver: enter SOLDNT and press -RETURN-. This loads 
both the SOL*Net driver and its protected mode extension. 


. You are now ready to usc SOL*Net over DECnet. 


At this point using SQL*Net is transparent to you as a user. 
Follow the documentation for any of the ORACLE tools on 
how to connect to ORACLE. Whether you work against a 
local databasc on your machine or a "local" database that is 
over DECNet, it is completely transparent to the tool. For 
example, you may enter: SQOLPLUS USERID/PASSWORD 
(where USERID/PASSWORD is a valid ORACLE userid 
and password). 
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CHAPTER 9. USING SQL*REPORT 


This chapter introduces SQL*Roeport. It describes the available 
documentation and suggests a way to learn SQL*Report. In 
addition, this chapter provides specific information about using 
SQL*Report under DOS. 


IMPORTANT DOCUMENTATION 


The SQL*Report documentation includes: 


e ORACLE for IBM PC/MS-DOS, Installation and User's 
Guide (this guide) -- contains installation instructions and in- 
formation specific to SQL*Report under DOS. 


® ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering SQL*Report using Professional ORACLE and 
Networkstation ORACLE. 


= SOL* Report User's Guide -- contains complete information 
on SQL*Report. Includes RPT and RPF reference informa- 
tion and examples. 


Chapter 9. Using SQL*Report / 107 


WHAT IS SQL*REPORT? 


SQL* Report is a versatile report generation program that al- 
lows you to format text and to embed database information in 
documents. 


SOL*Report comprises: 


# RPT -- the ORACLE Report Generator, for adding database 
information to reports. 


s RPF -- the ORACLE Report Text Formatter, for controlling 
the format of reports. 


Normally you use RPT first, to produce an interim document. 
You embed commands in text and include SQL statements to 
retrieve information from database tables. Then you use RPF 
to process the intcrim document, to format according to the 
commands and programming statements it encounters. 


RPF may also be used independently if you use a text editor to 
insert commands in a text file manually. 


With RPT and RPF you can create simple documents, such as 
letters, or complex reports containing tabular material, column 
heads, many levels of nesting, and subtotals and totals. You can 
also do things like generate letters whose names and mailing 
addresses are derived from database tables. 


LEARNING SQL*REPORT 


To learn SQL*Report, read the SQL*Report User's Guide. This 
guide describes SOL*Report and demonstrates how to use it 
through examples. We recommend you follow the examples 
carefully, then try to reproduce them. 


Read the guide in sequence. It describes RPF before RPT be- 

cause RPF can be used independently (without RPT). If you are 
interested in entering and formatting simple text only, you may 
wish to use RPF alone. If you are interested in accessing data- 
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base information for formatting, you will want to learn to use 
both RPT and RPF. 
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CHAPTER 10. USING THE PROGRAMMATIC INTERFACES 


This chapter introduces ORACLE 's programmatic interfaces: 
Pro*C, for the programming language C, and Pro*COBOL, for 
COBOL. It describes the available documentation and provides 
specific information about using the programmatic interfaces 
under DOS. 


IMPORTANT DOCUMENTATION 


The ORACLE programmatic interface documentation includes: 


a ORACLE for IBM PC/MS-DOS Installation and User's Guide 
(this guide) -- contains installation instructions and informa- 
tion specific to Pro*C under DOS. 


® ORACLE for IBM PC/MS-DOS System Release Bulletin -- 
may contain up-to-the-minute information on installing and 
administering the Programmatic Interfaces using Professional 
ORACLE and Networkstation ORACLE. 


u Pro*C User's Guide -- contains complete reference informa- 
tion for Pro*C. 


= Pro*COBOL User's Guide -- contains complete reference in- 
formation for Pro*COBOL. 
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WHAT IS A PROGRAMMATIC INTERFACE? 


A programmatic interface is a tool that enables you to write 
ORACLE database application programs in a procedural pro- 
gramming language. By writing such programs you can realize 
some of the advantages of two different approaches to data 
processing: the flexibility and efficiency of a procedural lan- 
guage, combined with the power and expressiveness of 
ORACLE. 


The ORACLE RDBMS supports several different 
programmatic interfaces for different programming languages. 
At present, two of these programmatic interfaces are available 
in DOS: 


Pro*C for Lattice C and Microsoft C (If using Pro*C for 
SQL*Forms User Exits, we support Lattice C only) 


Pro*COBOL for Realia COBOL 


LEARNING TO USE THE PROGRAMMATIC INTERFACES 


To learn to use one of the programmatic interfaces, you must 
first be familiar with the associated programming language. The 
programmatic interface documentation assumes that you have 
this familiarity. 


You can learn to use a programmatic interface on your own, 
using the appropriate User’s Guide. Read the first few chapters 
of the guide, which introduce you to the concepts and facilities 
of the interface. Use the later chapters for reference as you write 
programs. 
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INSTALLING AND REMOVING THE SAMPLE PROGRAMS 


Each programmatic interface is distributed with a set of sample 
programs. Thesc programs arc listed in the corresponding Us- 
er's Guide, and are installed in the sub-directory PRO in the 
home directory. You can delete them with DOS's ERASE or 
DEL command. You can re-install them by copying them back 
from the Pro*C installation disk. 


PROGRAMMATIC INTERFACES UNDER MS-DOS 


PRO*C 


All files for the programmatic interfaces are stored in the sub- 
directory PRO. 


The following subsections describe those aspects of the 
programmatic interfaces that arc different when you use them 
under MS-DOS. It docs not repeat gencral information that is 
available in the programmatic interface documentation. 


Both Lattice and Microsoft C precompiler support requires the 
use of the large modcl. Small and medium model support is not 
provided. The precompiler for Microsoft C and Lattice C is 
called PCC.EXE and the precompiler for Realia is called 
PCCCOBOL.EXE. 


Cursor Data Area definition for thc Programatic Interface on MS-DOS: 


The following information describes the Cursor Data Area De- 
finition for the Programmatic Interface on MS-DOS. This can 
be referenced in more detail in Chapter 8 of the Pro*C User's 
Guide. 
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RETURN CODE FUNCTION TYPE 
4 
ROWS PROCESSED COUNT 
: 10 AN 
PARSE ERROR OFFSET : FUNC CODE : FILLER 
12 
V4 ERROR CODE FLAGS1 FLAGS2 
16 18 
CURSOR NUMBER INTERNAL ROWID 
20 
INTERNAL ROWID - continued - 
24 
INTERNAL ROWID - continued - 
oo aaa iaatachaataataadateaTaaiaaan lente aah aaa ee e a e e m m e m e e e e ee e e e e e e e m = 0/S 
28 dependent 
INTERNAL ROWID - continued - 
32 33 34 
OSD ERR CHECK BYTE ORA. PARAMETERS 
36 
ORACLE SYSTEM PARAMETERS - continued - 63 
4R--------------2-2-----------------------------2---------2----------- + --- 


Note: this area is defined in the OCISAM.C programmatic interface example program. 
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Logon Data Area definition for the Programatic Interface on MS-DOS: 


The following information describes the Logon Data Area De- 
finition for the Programmatic Interface on MS-DOS. This can 
be referenced in more detail in Chapter 8 of the Pro*C User's 


Guide. 
42------2.--2-222-2-2-22.-222222222222-2-22-2222-2---2-2-2-2-2-2222-2-222-2222-2--2--2--2--- + 
RETURN CODE | FILLER 
4 
FILLER 
FILLER | FILLER FILLER 
12 : 14 
V4 ERROR CODE FILLER 
16 
FILLER - continued - 
28 31 
FILLER - continued - OSD ERROR 
duri II a ee 0/S 
32 : 33 : 34 dependent 
OSD ERR : CHECK BYTE : ORA. PARAMETERS 
36 
ORACLE SYSTEM PARAMETERS - continued - 63 
Re-----------2--2----2-22------------------2-------------2---2-2-2-2-22--2-- fi Seem 
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ORACLE Call Interface For Microsoft C 


ORACLE Call Interface supports Microsoft C version 4 and 
either Microsoft's linker V3.5] or Phoenix's PLINK86 plus 
V2.11. 


The link library for Microsoft C is SOLMSC.LIB. Two proto- 
type command files are given. For the Microsoft linker, the 
prototype command file is SOLMSC.MLN. For the Phoenix 
linker, the prototype command file is in SQLMSC.PLN (sec 
below). Note that you will need to change the occurrences of 
SAMPLE in SOLMSC.MLN, SOLMSC.PLN to OCISAM in 
order to link the OCISAM program as shown below. 


SOLMSC.MLN: 


ocisam. obj 
ocisam.exe 
ocisam.map 
c:Noracle5NproNsqImsc.lib /se:512 /stack:10000 /MAP 


SQLMSC.PLN: 


file ocisam. obj 

out ocisam.exe 

map=ocisam.map 

stack 2400 

search c:\oracle5\pro\sqimsc. lib 


To build and run the OCISAM program with Microsoft C, (it 
is assumed that the Microsoft C compiler, libraries, and linker 
are set up according to the compiler's User's Guide): 


C > msc -AL ocisam.c 
C > link Csqimsc.min 
C > ocisam 
Both Lattice and Microsoft C support requires the use of the 


large model. Small and medium model support is not provided. 
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ORACLE Call Interface For Lattice C 


ORACLE Call Interface supports Lattice C versions 3.0H (or 
higher) and cither Microsoft's linker (V3.05 or higher), IDM 
linker (V2.3 or higher), or Phoenix linker PLINK86 plus (V2.11 
or higher). 


The link library for Lattice C is in SOLLC.LIB. A prototype of 
a command file for linking Lattice C files with the IBM linker 
is given in SAMPLE.LNK. For the Microsoft linker, the pro- 
totype command file is in SAMPLE.MLN. For the Phoenix 
linker, the prototype command file is in SAMPLE.PLN. (Please 
see below for the respective file descriptions). 


Note that you will nced to change the occurrences of SAMPLE 
in SAMPLE.LNK, SAMPLE.MLN and SAMPLE.PLN, to 
OCISAM in order to link the OCISAM program as shown be- 
low. 


Note especially that use of "-1" to indicate missing optional ad- 
dress paramcters in OCI calls REQUIRES that the argument 
be cast to a pointer of the appropriate type, e.g., (char *)-1. 
Large model addresses are 32 bits, and attempting to pass "-1 
in a pointer position will generate a 16 bit unsigned integer. 


SAMPLE.LNK: 


” 


c:\lc\I\c. objt 

ocisam.obj 

ocisam.exe 

ocisam.map /MAP 
c:\oracle5\pro\sql lc. libt+t 
c:\Ic\l\1cm. 11ib+ 
c:\le\l\1c. lib /x:512 
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SAMPLE.MLN: 


c:\Ic\l\c. obj+ 

ocisam. obj 

ocisam.exe 

ocisam.map /MAP 
c:\oracle5\pro\sqlic. lib+ 
c:\lc\l\1cem. libt 
c:\Ic\l\lc. lib /se:512 


SAMPLE. PLN: 

file c:\Ic\l\c. obj 

file ocisam. obj 

out ocisam.exe 

map=ocisam.map 

search c:\oracle5\pro\sqllc. lib 
search c:\Ic\l\lcem. 11b 

search c:\lc\l\lc. lib 


To build and run the OCISAM program with Lattice C (it 1s 
assumed that the Lattice C compiler, librarics, and linker are set 
up according to the compiler’s User's Guide), enter the follow- 
ing: 


C > lc -mls -cdtw ocisam 
C > link @sample. Ink 
C > ocisam 


Both Lattice and Microsoft C support requires the use of the 
large model. Small and medium model support is not provided. 


Pro*C for Microsoft C 


Pro*C supports Microsoft C version 4.0 and either Microsoft's 
linker (V3.51 or Phoenix's PLINK86 plus (V2.11 or higher). 


The link library for Microsoft C is in SOLMSC.LIB. Two pro- 
totype command files are given. For the Microsoft linker, the 
prototype command file is in SQLMSC.MLN. For the Phoenix 
linker, the prototype command file is in SQLMSC.PLN. (Please 
see below for the respective file descriptions). 
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Pro*C for Lattice C 


SOLMSC.MLN: 


sample.obj 
sample.exe 
sample.map 
C: NoraclebNproNsqImsc.lib /se:512 /stack: 10000 /MAP 


SQLMSC . PLN: 

file sample.obj 

out sample.exe 

map-sample.map 

stack 2400 

search c:\oracle5\pro\sqimsc. lib 


To build and run the SAMPLE program with Microsoft C 
(when following this example, it is assumed that SQLCA.H is 
in the C:\ORACLES\PRO directory and the Micorsoft C com- 
piler libraries, and linker are set up according to the compiler's 
User's Guide): 


pcc iname=sample.pc host=c include=c: \oracle5\pro\ 
msc -AL sample.c 

link Gsqimsc.min 

sample 


V MM M 


C? €) C) CD 


Both Lattice and Microsoft C support requires the usc of the 
large model. Small and medium model support is not provided. 


Pro*C supports Lattice C versions 3.0II or higher and either 
Microsoft's linker (V3.05 or higher), IBM linker (V2.3 or 
higher), or Phoenix linker PLINK86 plus (V2.11 or higher). 


The link library for Lattice C is in SQLLC.LIB. A prototype of 
a command file for linking Lattice C files with the IBM linker 
is given in SAMPLE.LNK. For the Microsoft linker, the pro- 
totype command file is in SAMPLE.MLN. For the Phoenix 
linker, the prototype command file is in SAMPLE.PLN. (Please 
sec below for the respective file descriptions). 
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SAMPLE.LNK: 


c: NM cNINC.obj* 

sample.obj 

sample.exe 

sample.map /MAP 
c:\oracle5\pro\sqllc. lib 
c: NcNI NI cm. Tib 

c: MceMINICc.lTib /x:512 


SAMPLE.MLN: 


c: NceNI NC. obj* 

sample.obj 

sample.exe 

sample.map /MAP 

c: Noracle5NproNsqllc.lib* 
c: M ceNINIOm. Tib 

c: McNINIC. 11b /se:512 


SAMPLE . PLN: 

file c:\Ic\l\c. obj 

file sample. obj 

out sample.exe 

map=sample.map 

search c:\oracle5\pro\sqllc. lib 
search c:\lc\l\lem. lib 

search c:\lc\l\lc. lib 


To build and run the SAMPLE program with Lattice C (it 1s 
assumed that SQLCA.I is in the C:\ORACLES\PRO\ directory 
and the Lattice C compiler, libraries, and linker are set up ac- 
cording to the compiler's User's Guido), enter the following: 


pcc iname=sample.pc host=c include=c:\oracle5\pro\ 
lc -mls -cdtw sample 

link @sample. Ink 

sample 


V MM M 


C»? C) CD CÓ 


Both Lattice and Microsoft C support requires the use of the 
large model. Small and medium model support is not provided. 
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Pro* COBOL for Realia COBOL 


Pro*COBOL supports Realia COBOL version 2.0 or later. The 
link library for Realia COBOL is in SQLCOB.LIB. A prototype 
of a command file for the IBM linker (version 2.3 and above), 
is given in SQLCOB.LNK. For the Microsoft linker (version 
3.05 and above), a prototype of a command file is given in 
SQLCOB.MLN. 


The ProtCOBOL PCC exccutable is called PCCOBOL.EXE. 


Please make sure prior to using the sample program that Realia 
is installed correctly. 


When using Pro*COBOL, the following points should be noted: 


1. When declaring HOST integer variables (Pro*COBOL User's 
Guide Version 1.1, page 10), they must be declared as 
COMP-5. This will ensure proper functioning of these vari- 
ables. 


2. The default for PCC when specifying COBOL or 
<filename> .pco is the Realia COBOL compiler. 


3. When compiling Pro* COBDOL programs with Realia, use the 
/Q option. This will prevent numcrous warning messages 
which are harmless. 


4. Follow the library ordering in the sample link files. This will 
ensure a fairly smooth link. There will probably be 1 dupli- 
cate symbol message. This docs not cause a problem with the 
resulting executable. 


To precompile, compile and link the supplied sample program, 
SAMPLE.PCO, follow thesc steps: 


1. To pre-compile the sample program, enter: 

C > PCCOBOL iname= SAMPLE.PCO This creates the 
files SAMPLE.COB, which is the input file for the Realia 
COBOL compiler, and SAMPLE.LIS, which is the precom- 
piler list program. 


2. To compile the sample program, enter: 
C » REALCOB/Q SAMPLE; 
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This generates the object file, SAMPLE.OBJ. The sample 
program will generate about 16-18 warning messages which 
arc harmless and dcal with the placement of spaces and quo- 
tations. 


3. To link the sample program using the IBM linker, enter: 
C > LINK @SQLCOB.LNK or, with the Microsoft linker, 
enter: 
C > LINK @SQLCOB.MLN 


The contents of the IBM linker command file is: 


sample.obj+ 

\realcob\1c1310. obj 

sample.exe 

sample.map 
\oracle5\pro\sqlcobol. 1ibt+t 
\realcob\realcob. 1ib+ 

\Ie\1\1c. 1ibt 

\Iic\I\lem. Jib /stack:10000 /x:512 


USER EXITS FOR PRO*C 


A user exit is a user-written subroutine or set of subroutines 
which is invoked by SQL*Forms as a step in a trigger. Though 
user exits are a feature offered for SQL* Forms, they are written 
using the Pro*C precompiler in DOS. 


When working with user exits, be sure you have the SOL* Forms 
Designer's Reference. It has generic information on the use of 
user exits with IAP. 


User exits with IAP in the PC/MS-DOS environment are cur- 
rently supported only for Lattice C linked with the following 
linkers: Phoenix Linker PLINK86+, IBM or Microsoft. You 
will also need a copy of an IBM or Microsoft Assembler. 


To create a user exit, follow this procedure: 


1. Run GENXTB <USER/PASSWORD> with no output file 
to create tables for use by the GENXTB form. 
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. Use RUNFORM to run the GENXTB form. Enter your 


USER EXIT INFORMATION into the database. 


. Run GENXTB < USER/PASSWORD ^? «assembler file>. 


An assembler file is generated which may be assembled with 
the Assembler. This will provide you with an .OBJ file. 


. Write your user exit in C and compile it using PCC and the 


Lattice C compiler. An example user exit source file, 
testexit.pc, is included. To compile testexit.pc, please refer to 
the section called, "Pro*C for Lattice". If you compile the 
example program, you will get two warning lines which are 
expected and normal. 


. Link your PCC user exit with IAP (RUNFORM ). Sample 


linker command files are provided for IBM 
(IAPUSER.LNK), Microsoft (IAPUSER.MLN), and 
Phoenix (IAPUSER.PLN), shown below. 


a) When creating your own new user exit you will need to 
edit the appropriate link file to change the name of the .exe 
file to a name of your choice and replace TESTEXIT.OBJ 
with the name of your program. 


b) To link, run PLINK86 @IAPUSER.PLN’ or LINK 
@IAPUSER.LNK’. 
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Sample link files for IBM (IAPUSER.LNK), Microsoft 
(IAPUSER.MLMN), and Phoenix (IAPUSER.PLN), are shown 
below: 


IAPUSER.LNK: 


:NleNMNc.obj* 
:NoraclebNproNbigstack.obj* 
:\oracle5\pro\cxnm8. obj+ 
:\oracle5\pro\dummy. obj 
:\oracle5\pro\tapdrv.objt+ 
:\oracle5\pro\lapusd. obj+ 
:\oracle5\pro\memchr. obj+ 
:\oracle5\pro\osbdef. obj+ 
:\oracle5\pro\osgdef. obj* 
:\oracle5\pro\rtsup. obj+ 
:\oracle5\pro\_sfmt. obj+ 
c:\oracle5\pro\usdtio. obj+ 
testexit.objt+ 

japxtb. obj 

lapuser.exe 

japuser.map /MAP /X:512 
c:\oracle5\pro\iapuser2. 1 ib* 
c: Noracle5NproNsqlicalc.lib* 
c: M cNI Nem. Tib 

c: MceNINIC. Tib 


O00005005»50550505»00 
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PLINK86+ also works, using the following example script: 


IAPUSER.PLN: 


output — lapuser.exe 
file Cc: NoraclebNproNiapuserl.lib 


file testexit.obj 
file japxtb. obj 
NODEFLIB 


MAP-iapuser.map 

search  c:\oracle5\pro\fapuser2. lib 
search  c:\oracle5\pro\sqlic.lib 
search c:\Ic\l\lem.1ib 

search c:\Ic\lc.lib 


The example user exit was constructed using Lattice C, Version 
3.0H. 


IAPUSER.MLN: 


:NMeNINc.obj* 
:\oracle5\pro\bigstack. obj+ 
:\oracle5\pro\cxnm8. obj+ 
:\oracle5\pro\dummy. obj+ 
:\oracle5\pro\fapdrv. obj+ 
:\oracle5\pro\fapusd. obj+ 
:\oracle5\pro\memchr. obj+ 
:\oracle5\pro\osbdef. obj* 
:\oracle5\pro\osgdef. obj+ 
:\oracle5\pro\rtsup. obj+ 
:\oracle5\pro\_sfmt. obj+ 
c:\oracle5\pro\usdtio. objt+ 
testexit.obj- 

iapxtb.obj 

lapuser.exe 

lapuser.map /MAP /SE:512 
c:\oracle5\pro\iapuser2. lib* 
c:\oracle5\pro\sqllc. lib+ 
c:\Ic\l\lem. lib+ 

c: NceNINIC.T1b 


O00000500550505»05050 
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USER EXITS FOR PRO*COBOL 


A user exit is a user-written subroutine or sct of subroutines 
which is invoked by SQL*Forms as a step in a trigger. Though 
user exits arc a feature offered for SOL*Forms, they are written 
using the ProtCOBOL precompiler in DOS. 


When working with user exits, be sure you have the SOL*lorms 
Designer's Reference. It has gencric information on the use of 
user exits with IAP. 


User exits with IAP in the PC/MS-DOS environment are cur- 
rently supported only for Realia Cobol. You will also need a 
copy of an IBM or Microsoft Assembler. 


To create a user exit, follow this procedure: 


1. Run GENXTB <USER/PASSWORD> with no output file 
to create tables for use by the GENXTB form. 


2. Use RUNFORM to run the GENXTB form. Enter your 
USER EXIT INFORMATION into the database. When 
using the GENXTB form, make sure that the type of user exit 
entered is COB for COBOL. Otherwise, User Exits will not 
work. 


3. Run GENXTB <USER/PASSWORD> «assembler file>. 
An assembler file is generated which may be assembled with 
the Assembler. This will provide you with an .OBJ file. 


4, Write your user exit in Cobol and compile it using PCC 
COBOL and the Realia Cobol compiler. An example user 
exit source filc, testexit.pco, is included. 


5. Link your PC Cobol user exit with IAP (RUNFORM ) using 
one of the sample link files provided (scc below). Depending 
on your programming environment, you may need to edit 
these files accordingly. There will be a couple of duplicate 
symbol messages. This docs not cause a problem with the 
resulting exccutable. 


a) When creating your own new user exit you will need to 
edit the appropriate link file provided to change the name 
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of thc .exe file to the name of your choice, and replace 
TESTEXIT.OBJ with then name of your program. 


b)’ To link, run 'PLINK86 @IAPCOBOL.PLN’ or 'LINK 
(QIAPCOBOL.LNK'. 


IAPCOBOL.LNK: 


LINKER FILE STATEMENTS 


:NleNINc.obj* 
:Noracle5NproNbigstack.obj* 
:\oracle5\pro\cxnm8. obj+ 
:\oracle5\pro\dummy. obj 
:\oracle5\pro\fapdrv. obj+ 
:\oracle5\pro\iapusd. obj+ 
:\oracle5\pro\memchr. obj* 
:\oracle5\pro\osbdef. obj* 
:\oracle5\pro\osgdef. obj+ 
:\oracle5\pro\rtsup. obj+ 
:\oracle5\pro\_sfmt. obj+ 
c:\oracle5\pro\usdtio. obj+ 
testexit. obj+ 
c:\oracle5\pro\cc_exit. objt+ 
japxtb. obj 

lapuser.exe 

iapuser.map /MAP /X:512 
c:\oracle5\pro\tapuser2. libt+ 
c: Noracle5NproNsqlcobol.lib* 
c:\realcob\realcob. lib+ 
c:\Ic\l\lem. 1ib+ 

c: MceNINIC. Tib 


O000005705705505»050757 Oo 


COMMENTS 


Lattice C startup 
objects from lapuserl.lib 
" n 


User program 
Cobol interface module 

IAP exit table from genxtb 
exe file 

map file 

IAP object library 
Pro*COBOL link library 
Realia COBOL library 
Lattice C math library 
Lattice C runtime library 
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PLINK86+ also works, using the following example script: 


IAPCOBOL.PLN: 


LINKER FILE STATEMENTS 


output 
file 
file 
file 
file 


NODEFLIB 


lapuser.exe 
c:\oracle5\pro\iapuserl. lib 
c:\testexit. obj 
c:\oracle5\pro\cc_exit. obj 
japxtb. obj 


MAP-iapuser.map 


search 
search 
search 
search 
search 


c:\oracle5\pro\iapuser2. lib 
c:\oracle5\pro\sqlcobol. lib 
c:\realcob\realcob. lib 
:NtoolsNTceNI NI cm. lib 
c:\tools\Ic\l\lc. lib 


Q 


COMMENTS 


exe file 

IAP lib w/ startup routines 
user program 

Cobol interface module 

IAP exit table from genxtb 
disable default lib searche 
map file 

IAP object library 
Pro*COBOL link library 
Realia COBOL library 
Lattice C math library 
Lattice C runtime library 


The example user exit was constructed using Realia Cobol, 


Version 2.0. 
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IAPUSER.MLN: 


LINKER FILE STATEMENTS 


:NleMINc.obj* 
:\oracle5\pro\bigstack. obj+ 
:\oracle5\pro\cxnm8. obj+ 
:\oracle5\pro\dummy. obj+ 
:\oracle5\pro\tapdrv. objt+ 
:\oracle5\pro\iapusd. obj+ 
:\oracle5\pro\memchr. objt+ 
:\oracle5\pro\osbdef. obj* 
:\oracle5\pro\osgdef.obj+ 
:\oracle5\pro\rtsup. obj+ 
:\oracle5\pro\_sfmt. obj+ 
c:\oracle5\pro\usdtio. obj+ 
testexit.obj+ 
c:\oracle5\pro\cc_exit.objt+ 
fapxtb. obj 

japuser.exe 

fapuser.map /MAP /SE:512 
c:\oracle5\pro\iapuser2. ]ibt 
c: NoraclebNproNsqlcobol.11b* 
c:\realcob\reaicob. 1 1b* 
C 
C 


O0050550575005 000000 


:MeNINIcm. Tib 
:NIleMINIC. lib 


COMMENTS 


Lattice C startup 
objects from iapuserl.lib 
" 


user program 

Cobol interface module 

IAP exit table from genxtb 
exe file 

map file 

IAP object library 
Pro*COBOL link library 
Realia COBOL library 
Lattice C math library 
Lattice C runtime library 
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APPENDIX A. ORACLE ERROR MESSAGES AND CODES IN DOS 


This section lists error messages and codes that are specific to 
DOS. These messages and codes either do not appear in the 
ORACLE Error Messages and Codes manual at all, or have a 
different meaning in DOS which is described here. 


ORACLE RDBMS ERRORS UNDER DOS 


ORA-0520: trying to write block outside of file 
Cause: An attempt was made to write outside the bounds of an 
ORACLE file. This is an internal error and should not normally 


occur. 


Action: Contact your customer support representative. 


ORA-0521: trying to read block outside of file 
Cause: An attempt was made to read from outside the bounds 
of an ORACLE file. This is an internal error and should not 


normally occur. 


Action: Contact your customer support representative. 
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ORA-0532: osscpr: Sparse failure 


Cause: An error occurred while ORACLE was trying to open 
the after-image journal file. 


Action: Be sure that the disk that is to contain the file is in 
working order and has enough free space for the file. If this does 
not resolve the problem, contact your customer support repre- 
sentative. 


ORA-0552: osdcoj: after image file create failure 


Cause: An error occurred while ORACLE was trying to write 
the after-image journal file. 


Action: Be sure that the disk that is to contain the file is in 
working order and has enough free space for the file. If this does 
not resolve the problem, contact your customer support repre- 
sentative. 


ORA-0553: osdcoj: after image file close failure 


Cause: An error occurred while trying to close the after image 
journal file. 


Action: Contact your customer support reprcsentative. 


ORA-1034: ORACLE not available 
Cause: ORACLE is not running. It has been loaded (via 
SQLPME), but has not been started using IOR, or has been 
shut down using IOR Shut or CLEAR. 


Action: Use IOR to start ORACLE. 
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ORA-1901: 


ORA-1902: 


ORA- 1903: 


ORA- 1904: 


ORA- 1905: 


ORA- 1920: 


osdcfi: file close error 
Cause: An error occurred while trying to close a file. 


Action: Contact your customer support representative. 


osdofi: file open error 
Cause: An error occurred while trying to open a file. 


Action: Contact your customer support representative. 


osdrfb: file read error 


Cause: An error occurred while trying to read a block from a 
database or before image file. 


Action: Verify that the disk drive containing the files is working. 


osdwfhb: file write error 


Cause: An crror occurred while trying to write a block to a da- 
tabase or before image file. 


Action: Verify that the disk drive containing the files is working. 


osd-rw-fh: file seek error 


Cause: An error occurred while trying to position a database or 
before image file. 


Action: Verify that the disk drive containing the files is working. 


exception occurred. 
Cause: A fatal ORACLE error has occurred. 


Action: Contact your customer support representative. 
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ORA-1944: configuration variable bad 


Cause: ORACLE encountered a CONFIG parameter (e.g., in 
the CONFIG.ORA file) whose name or value is invalid. 


Action: Correct the CONFIG parameter and run the program 
you were trying to run when the error occurred. 


OR A-1945: can't allocate variable SGA 


Cause: There is not enough extended memory to allocate the 
System Global Area (SGA). 


Action: Ensurc that there is enough extended memory to run 
ORACLE. The ORACLE Database Administrator’s Guide ex- 
plains how to control the amount of extended memory 
ORACLE uses for the SGA. The minimum that ORACLE 
needs to run is 896 Kb. 


ORA-1946: can't allocate cache buffers 


Cause: There is not enough extended memory to allocate the 
cache buffer. 


Action: Ensure that enough extended memory is available, or 
reduce the amount that ORACLE rcquests. The ORACLE Da- 
tabasc Administrator’s Guide explains how to control the 
amount of extended memory ORACLE uses for cache buffers. 
The maximum amount that should be required is 63K. 


ORAÀ-1947: can't allocate Before- Image buffers 


Cause: There is not enough extended memory to allocate the 
Before-Image buffers. 


Action: Ensure that enough extended memory is available, or 
reduce the amount that ORACLE requests. The ORACLE Da- 
tabase Administrator's Guide explains how to control the 
amount of extended memory ORACLE uses for before-image 
buffers. The maximum amount that should be required is 10K. 
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ORA-3100: no space for communication buffers 


Cause: There is not enough extended memory to allocate the 
communication buffers. 


Action: Ensure that enough extended memory is available, or 
reduce the amount that ORACLE requests. The ORACLE Da- 
tabase Administrator's Guide explains how to control the 
amount of extended memory ORACLE uses for communication 
buffers. The maximum amount that should be required is 10K. 


ORA-3120: ttci2u: integer overflow 


Cause: A heterogenous SQL*Net conversion detected an invalid 
integer conversion. 


Action: Call customer support. 


ORA-3121: SQL*Net driver could not be found 


Cause: An attempt was made to connect (log in) using a 
SQL*Net driver prefix which is invalid. If you have the driver, 
it is not loaded in MS-DOS or not configured at the host. For 
example, "connect scott/tiger@a:” will give error 3121 if the 
asynchronous driver has not been configured using "nconfig" 
on VMS, or if SOLASYNC.EXE has not bcen executed in 
MSDOS. 


Action: Be surc that you arc entering a valid driver prefix, and 
that the requested driver is loaded or properly configured. 


EXP ERROR MESSAGES 


Appendix A. ORACLE Error Messages and Codes in DOS / 137 


Can't create file: insert next diskette and 
enter the name of the next file (default <...>), or . to abort: 


Cause: An invalid filename was entered. 
Action: Enter a valid filename. 

Device full: insert initialized diskette and 

enter the name of the next file (default <...>), or . to abort: 


Cause: The device to which the export file is being written 1s full, 
and export needs a new diskette on which to continue. 


Action: Enter [Rcturn] to accept the default, ’.’ to abort the ex- 
port, or any valid filename, including device specification. Ifa 
new filename is specified, when that file is exhausted, the default 
becomes the same device and filename with the next higher ex- 
tension number; that is, if it is the [Sth file, the extension will 
be .015 even if you never select .001 through .014. 


IMP ERROR MESSAGES 


Can't open file. Insert proper diskette and 
enter the name of the next file (default <... >), or . to abort: 


Cause: IMP could not open the specified file. 


Action: [nsert a diskette which contains the contains the correct 
file, specify the correct filename, or abort the export. 
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End of file: insert next diskette and 
enter the name of the next file (default <...>), or . to abort: 


Cause: IMP dctected an end of file condition prior to the end 
of the export data. 


Action: The user should insert the next diskette and/or specify 
the name of the next file. 
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APPENDIX B. CONFIG PARAMETERS AND THE CONFIG.ORA FILE 


THE CONFIG FILE 


If you are a user of the ORACLE RDBMS under DOS, you can 
customize your ORACLE configuration by changing the 
CONFIG parameter values defined in the CONFIG file. By 
default, the CONFIG file is named CONFIG.ORA, and is read 
from the home directory. 


Professional ORACLE and Networkstation ORACLE recog- 
nize somewhat different sets of CONFIG parameters. You 
should only use parameters that are meaningful to the version 
of ORACLE that you are running. The parameter descriptions 
point out which parameters are not meaningful to both versions 
of ORACLE. 


When you perform a standard ORACLE installation, you in- 
stall a file named CONFIG.ORA that contains DOS-specific 
configuration parameters and their default values. 
CONFIG.ORA is an ASCII text file located in the 

ORACLE IIOME directory which is by default \ORACLES. 
It is read every time you start ORACLE with the ORACLE 
command, use the IOR command, or start any ORACLE tool 
or other program that uses the ORACLE RDBMS locally or 
remotely. 


A CONFIG file (by default, CONFIG.ORA) is used in one step 
of a procedure that sets cach CONF IG parameter from one of 
several alternative sources. ORACLE will use a parameter value 
specified in the CONFIG file unless you specify a different value 
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in another location that has higher priority. ORACLE's proce- 
dure for setting CONFIG parameter values is described in detail 
in "Chapter 4. Customizing Your Installation" on page 39. 


Each line of a CONFIG file specifics one parameter's value in 
the following format: 


parameter - value 


For example, you would set the ORACLE DBS parameter to 
the value "TESTDBS" like this: 


ORACLE DBS = TESTDBS 


As 1s explained in "Chapter 4. Customizing Your Installation” 
on page 39 you may refer to the current value of another 
CONFIG parameter by surrounding that parameter's name 
with percent signs: 


ORACLE MSG = %ORACLE_DBS% 


You may modify the contents of a CONFIG file with any text 
editor, such as EDLIN. 


If ORACLE is not installed in the default directory ORACLES, 
you must set thc environment variable CONFIG to point to the 
new ORACLE HOME directory. 


ABOUT THE CONFIG PARAMETER DESCRIPTIONS 


Most CONFIG parameters take effect only at startup. Param- 
eters that may usefully be changed any time you invoke an 
ORACLE program or tool (i.e., at any log-on) are identified 
individually. 


Acceptable parameter name abbreviations appear in parenthe- 
ses. 
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THE CONFIG PARAMETERS 


CONFIG parameters control such things as the name of the 
ORACLE home directory, the method used to display output 
on the screen, and thc command to be used to spool files to the 
printer. 


For Networkstation ORACLE (or Professional ORACLE with 
SQL*Net), CONFIG parameters also determine the driver to 
be used for network communications and the values SQL*Net 
should use for its operating parameters. 


The CONFIG.ORA file supplied by the installation procedure 
for Professional ORACLE contains one line: 


ORACLE TIO-VIDEO 


ASYNC MEMORY (ASY) 


Default: 12 

Legal Values: any non-zero integer 

Meaningful for: Professional ORACLE with SQL*Net, or 
Networkstation ORACLE 


Specifics how many kilobytes (Kb) of RAM the SQL*Net 


asynchronous driver will usc for buffers and other types of 
dynamic data storage. 
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DYNAMIC MEMORY (DYN) 


Default: all of free memory 
Legal Values: any positive integer. 
Meaningful for: Professional ORACLE 


Specifies a number of kilobytes (Kb) of extended memory 
ORACLE is to usc. If you do not specify a value, or specify 
a value greater than the amount of extended memory 
available, ORACLE will use as much extended memory as 
is available. 


You can usc this parameter to reserve space in extended 
memory for use by other programs that are run after 
ORACLE is started. You need not (and should not) use it 
to reserve space for a virtual disk controlled by the device 
driver VDISK.SYS, since such a virtual disk 1s allocated 
before ORACLE is started. 


GDTSIZ (GDT) 


Default: 12,000 
Legal Values: 10,000-65535 bytes. 


GDTSIZ is a global descriptor table size. This variable 
indicates the size of thc GDT which is to be left in memory 
while the kernel 1s loaded. Setting the GDT to a smaller 
size is not recommended, but increasing the size may be 
required for some applications. 


INTERRUPT (INT) 
Default: 99 (hexadecimal 63) 
Legal Valucs: any valid interrupt vector 


Meaningful for: all configurations 


Specifies the interrupt vector address that ORACLE will 
use. 
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LOCAL (LOC) 


Default: S: 

Legal Valucs: any valid SQL*Net driver prefix 
Meaningful for: Professional ORACLE with SQL*Net, or 
Networkstation ORACLE 


Specifies the SQL*Net driver and operating parameters to 
use when no communications driver is specified upon 
starting an ORACLE tool or an application program that 
uses the ORACLE RDBMS. This parameter enables the 
DBA to define a “default” network connection. When the 
user logs on without specifying any network parameters, 
ORACLE uses the LOCAL connection. Thus the fact that 
the database may be remote, and is used through 

SQL* Net, is made invisible. 


Note that the default value of 'S:' (Single-task driver, i.e., 
the local database) is meaningful only for Professional 
ORACLE. Networkstation ORACLE cannot have a local 
database. 


For information about driver names that are valid for 
DOS, sec "Chapter 8. Using SOL*Nct" on page 93. 


May be changed at any log-on. 


LU2 3270DRY (327) 


Default: 12 

Legal Valucs: any non-zero integer 

Meaningful for: Professional ORACLE with SQL*Net, or 
Networkstation ORACLE 


Specifics how many kilobytes (Kb) of RAM the SQL*Net 


3270 driver will usc for buffers and other types of dynamic 
data storage. 
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ORACLE DBS (ORACLE D) 


Default: DBS 
Legal Values: any directory namc 
Meaningful for: all configurations 


Specifies a sub-directory in thc ORACLE HOME direc- 
tory where ORACLE database and other files are stored. 


May be changed at any log-on; but changes after 
ORACLE is started do not affect the locations of the da- 
tabase files and before-image files. 


ORACLE HOME (ORACLE H) 


Default: \ORACLES on the current default drive 
Legal Values: any DOS directory on any drive 
Meaningful for: all configurations 


Specifies the “home directory" in which ORACLE is in- 
stalled. 


ORACLE executable files are customarily kept in the sub- 
directory BIN in the ORACLE HOME directory. 


The ORACLE database is kept in the ORACLE DBS 
sub-directory (customarily DBS) in thc ORACLE HOME 
directory. 


May be changed at any log-on. Note, though, that changes 
after ORACLE is started do not affect the locations of the 
database files, before-image file, or after-image journal file 
(specified by ORACLE DBS). 
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ORACLE SPOOLER (ORACLE S) 


Default: none 

Legal Values: any valid command to spool files to the 
printer 

Meaningful for: all configurations 


Specifies thc command to use to send files to the printer. 
ORACLE tools usc this command to control the spooler. 
When an ORACLE tool attempts to spool a file name, 
ORACLE will fulfill the request by executing the DOS 
command: 


oracle spooler filename 


For example, if the valuc of ORACLE SPOOLER is 
PRINT and an ORACLE tool attempts to spool a file 
named RESULTS.DAT, ORACLE fulfills the request by 
issuing the DOS command: 


PRINT RESULTS.DAT 


The spooler should be started (loaded into RAM) before 
any program that may spool output (e.g., SOL*Plus) is run 
to prevent memory from being fragmented. 


May be changed at any log-on. 
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ORACLE TIO (ORACLE T) 


Default: VIDEO 
Legal Values: VIDEO, BIOS, ANSI 
Meaningful for: all configurations 


Specifies the output technique that ORACLE tools, such 
as SQL*Forms and SQL*Calc, will use for writing to the 
display. 


VIDEO specifics output directly to the computer's display 
hardware. This is the most cfficient technique, but may be 
used only if your computer’s display adapter card is 100% 
IBM compatible. 


BIOS, specifies output with DOS BIOS calls. This 1s a less 
efficient technique than VIDEO but is more efficient than 
ANSI. It requires an operating system whose BIOS calls 
are compatible with PC-DOS. Most operating systems that 
are compatible enough to run ORACLE support BIOS 
output. 


ANSI specifies output with ANSI standard escape se- 
quences. This requires an ANSI device driver (normally 
ANSI.SYS). It is the least efficient mode of output, but 
makes the lowest demands on a computer's IBM compat- 
ibility. 

If ANSI is used, the Default. CRT file must be changed. See 
the discussion of CRT files in "Chapter 4. Customizing 


Your Installation" on page 39. 


May be changed at any log-on. 
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REMOTE (REM) 


Default: A: 

Legal Values: any valid SOL*Net driver prefix and pa- 
rameters 

Meaningful for: Professional ORACLE with SOL*Net, or 
Networkstation ORACLE 


If a user logs on and specifics a connection with an explicit 
driver prefix matching the onc specified in REMOTE, but 
specifies no parameters, the parameters specified in RE- 
MOTE are used. This parameter enables the DBA to define 
a "normal" network connection for which the SQL*Net or 
SQL*Star user need not specify connection parameters. 


May be changed at any log-on. 


SOC MEMORY (SOC) 


Default: 12 

Legal Values: any non-zero integer 

Meaningful for: Professional ORACLE with SQL*Net, or 
Networkstation ORACLE 


Specifics how many kilobytes (Kb) of RAM the SOL*Net 
DECnet driver will use for buffers and other types of dy- 
namic data storage. 


USERNAME (USER) 


Default: none 

Legal Values: any valid OPSS$ user ID (without the OPS$ 

prefix) 

Meaningful for: Professional ORACLE 

USERNAME spccifies the variable part of a user ID that 

begins with the fixed character string “OPS$’. For example, 
if OPSSTOM is a valid user ID, a valid USERNAME value 
1S: 


USERNAME = TOM 
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Since a user ID may not be more than 30 characters long, 
the variable part of an OPS$ user ID may not be more than 
26 characters long. 


ORACLE assigns the user ID specified by USERNAME 
to anyone who logs on without providing a user name (i.e., 
anyone who presses ENTER in response to a "user ID" 
prompt). You can usc this facility to free a user or a class 
of users from having to log on and remember passwords. 


The user ID specified by USERNAME must be a valid user 
ID defined in the usual way with the GRANT command; 
for example: 


SQL>GRANT CONNECT, RESOURCE TO OPS$TOM IDENTIFIED BY HUDDLES; 


A^ user who logs on without specifying a user ID or pass- 
word receives whatever privileges were granted to the OPS$ 
user ID. 


You can define several classes of "OPSS$ users" by specify- 
ing different user IDs in different CONFIG files. Specify 
each CONFIG file with a CONFIG command line option 
in a batch file written for use by cach class of user. 
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UTILITY MSG (UTIL) 


Default: \YORACLE HOME%\% ORACLE DBS%\ 
Legal Values: any directory 


Specifies a sub-directory in the ORACLE HOME direc- 
tory where error messages issued by ORACLE audit tools 
and utilities are kept. | 


You can have more than one set of message files and use 
this parameter to name the set for a particular configura- 
tion. 


May be changed at any log-on. 
XMMITR 


Default: 100 decimal (Hex 64) 
Legal Values: Any valid interrupt vector 


XMMITR (Extended Memory Manager Interrupt Vector) 
This variable indicates the interrupt vector which is to be 
used for the extended memory manager/mode transition 
driver (XMM/M TD) interrupt services entrypoint. In or- 
der to set a different vector, the new interrupt vector is ex- 
pressed as a decimal number. XMMITR should be used 
only if another program in your system needs to use inter- 
rupt 100 (64 hex). 
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APPENDIX C. CREATING A CUSTOMIZED DATABASE 


This appendix explains how to create an ORACLE database 
from scratch, and suggests reasons why you may wish to do so. 


Since the ORACLE installation procedure creates a database 
automatically, and the EXPAND command may be used to ex- 
pand the database when it becomes too small, there is seldom 
a need for a uscr to create a customized database. 


You may wish to create a customized database if you need to 
create a database that is smaller than the one installed with 
ORACLE. This might bc necessary if your fixed disk is nearly 
full and you need to free some space for other uses. It might 
also be necessary if you are building a specialized database sys- 
tem around the ORACLE RDBMS, and necd to build a data- 
base that contains specific data and is small enough to 
distribute on a diskette. 


We recommend that you attempt to build a customized data- 
base only if you are familiar with the use and management of 
the ORACLE RDBMS, and have installed ORACLE Version 
5.1 for DOS and familiarized yourself with it. 


STEP 1: EXPORT YOUR DATA 


Export any data that you want to transport from ORACLE's 
standard database to the customized database. Use the EXP 
utility, described in the ORACLE Utilities User's Guide. You 
may export to a diskette, or to DOS files on your fixed disk. 
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You nced not export the system tables which define the data 
dictionary, etc.; the database initialization procedure will recre- 
atc them. 


STEP 2: DISTINGUISH THE NEW DATABASE FROM THE ORIGINAL ONE 


To create a customized database, you must create at least two 
DOS files -- the primary databasc file and the Before-Image file 
-- to hold database data. There are threc ways you can distin- 
guish these files from the corresponding files in ORACLE's 
standard database: 


= By giving them different names 
= Dy putting them in a different sub-directory 


= By deleting the standard database's files before you create the 
customizcd databasc's files 


We strongly recommend the first or second approach. In this 
appendix wc will assume that you follow thc first approach; we 
will refer to the primary database file by the name 
CUSTDB.ORA, and the Before-Image file by the name 
CUSTBI.ORA. 


If you choose to store the customized database in a different 
sub-directory, you must place copics of the Database, Before- 
Image, *.msg, and *.crt files in the the new directory as well. 
You may copy these files from the standard database directory, 
\ORACLES\DBS. 


STEP 3: CREATE THE DATABASE FILE 


Use the Create Contiguous File Utility (CCF) to create the pri- 
mary database file. Enter the command: 


C» CCF C:\ORACLE5\DBS\CUSTDB.ORA n 


154 / ORACLE for IBM PC/MS-DOS Installation and User's Guide 


where the pathname determines the location and name of the 
file, and n is the size of the file in 512-byte DOS blocks. You can 
assign the file any size from a minimum of 1440 blocks to a 
maximum determined by the size of your disk. The size you 
choose will depend on the amount of data you intend to store. 
ORACLE adds one block to your number. 


CCF creates and initializes the file, then displays the message: 


FILE CREATED 


STEP 4: CREATE THE BEFORE-IMAGE FILE 


If your customized database is very different in size from the 
standard database, you should create a customized Before- 
Image file to accompany it. (You must do so anyway if you in- 
tend the customized database to exist completely independently 
of the standard one; for example, if you have chosen to place it 
in a different directory.) 


The Before-Image file records the state of the database prior to 
a scrics of operations (a transaction), up to the point the trans- 
action is committed. It allows you to perform a rollback to the 
original state of the database at any time before the transaction 
is committed. The Before-Image file is described in detail in the 
ORACLE Database Administrator's Guide. 


To create the Before-Imagce file, enter the command: 
C» CCF \ORACLES\CUSTOM\CUSTBI.ORA n 


Where n is the size of the file in 512-byte blocks. We recom- 
mend that you choose a size that is 1/3 to 1/2 the size of the 
database file that you created in the preceding step. See the 
ORACLE Database Administrator's Guide for a discussion of 
sizing this file. 


CCF creates and initializes the file, then displays the message: 


FILE CREATED 
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STEP 5: CHANGE INIT OR CONFIG FILE PARAMETERS 


Specify the new name and/or location of thc database and 
Before-Image files. 


There are a varicty of ways to do this, which you can explore 
by reading the descriptions of the INIT and CONFIG files in 
Chapter 3 and Appendix B. We will describe two basic ap- 
proaches. 


If you chose to define the new database and Bcfore-Image files 
with new names, specify their names with the DATABASE and 
BEFORE IMAGE parameters in the INIT file. (See the dis- 
cussion of the INIT file in Chapter 3 for details.) Note that 
these parameters specify the complete pathnames of the files, 
not just their file names. 


If you chose to store the customized database in a different 
sub-directory, change the value of ORACLE DBS in the 
CONFIG file. This will make ORACLE look to the new 
ORACLE DBS directory for all of the files that it normally 
finds in \ORACLES\DBS. 


STEP 6: INITIALIZE THE NEW DATABASE 


Next you must initialize the new database. You do this with the 
IOR utility. 


First, load ORACLE without warm starting it: 
C> ORACLE /NOIOR 
Then, enter the command: 
C> IOR I 
ORACLE informs you that this command erases the contents 


of the database, and asks you to confirm if you want to con- 
tinue. You must respond ‘YES’ (all capital letters). 
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When the database has been initialized, IOR displays the mes- 
sage: 


DATABASE INITIALIZED 


Note: since the IOR I command erases all data from an existing 
database, you normally should never use it after initializing the 
newly created database. Sec the ORACLE Database Adminis- 
trator s Guide for a full discussion of TOR. 


STEP 7: INSTALL THE SYSTEM CATALOG VIEWS 


ORACLE needs a number of system tables so that it can pro- 
vide data dictionary views, do exports and imports (backups and 
restores), and write reports. 


Make \ORACLES\DBS (or your customized database direc- 
tory) the current directory: 


C» CD \ORACLES\DBS — «RETURN» 
C» SQLPLUS SYSTEM/MANAGER (or newpassword) «RETURN» 


Install the data dictionary views: 
SQL>START CATALOG. ORA 


If you will be using SQL*Stars, you should install the database 
link view : 


Install the data dictionary vicws: 


SQL>START NEWCAT.ORA 


Please note that if you exported using the "Entire Database” 
option, and are going to import that file, you may skip STEP 
#7). 
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STEP 8: IMPORT YOUR DATA 


Import the data that you exported in Step 1. Use the IMP util- 
ity, described in the ORACLE Utilities User's Guide. 


If you exported the data to DOS files on your fixed disk, you 
will probably want to delete the files after you have used them. 


Please note that you will need to reload the SQL*Forms Ex- 
tended Data Dictionary tables by running FORMINS (unless 
you are importing after exporting using the "Entire Database" 
option. 
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